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While everyone else takes pot-shots at Apple, I’ve got to think 
that developers face a tremendous set of challenges. We've all 
got plenty on our plates just trying to build cool stuff for the 
Macintosh. The last thing we need is an entire media machine 
nay-saying the platform, especially when developers have rarely 
faced such a wide array of opportunities. 

The Macintosh developer has long had to deal with people 
who question the merit of developing for the Mac’s smaller 
market share. In fact, each of us probably has a sophisticated 
litany of justifications, good for dealing with friends, neighbors, 
co-workers, family, and people we bump into in computer stores. 
Well, I don’t know about you, but my real reason for doing 
Macintosh development is simple — Macintosh is cool. I still 
remember the mind-boggling paradigm shift I felt the first time I 
saw the interface. My notion of computing changed forever. 

As I learned to build Macintosh software, Icame to know 
not only the machine, but also the Macintosh Way. Guy 
Kawasaki popularized the phrase and offered cogent lessons for 
developers, but the Macintosh Way was evident even to those 
who didn’t benefit from his writings. 


Boldness to innovate 

The Macintosh screamed, “My inventors went way out on a 
limb when they built me!” While the rest of the world was 
clamoring for a faster, cheaper IBM PC-clone with more RAM 
and disk, a team of upstarts built what they thought a computer 
should really be. A graphical interface, a mouse, a synergistic 
blending of hardware/software, and even a large set of 
standardized routine libraries for programmers (complete with 
late-binding for those routines). 


Insistence on excellence 

Feature after feature, Macintosh pushed the limits of 
technology to benefit users. No one offered a CRT with square 
pixels, but Macintosh had them. And they were at a 1:1 ratio, 
making life for developers much sweeter. 

Auto-inject/auto-eject floppies. What can I say? It was 
cool, and users learned to love them. 

Documentation, well written and designed to serve the 
needs of real programmers. 


Confidence they'd come 

When they built Macintosh, the total market size was zero. 
There was absolutely no market whatsoever for it. Nevertheless, 
they pressed ahead, built it, and then did everything it took to build 
a market for it. Many of those efforts worked less well than others, 
but twenty-two million machines later, I must say, I’m impressed. 


4 | VIEWPOINT 


Thinking back to the early days, Apple wooed developers 
vigorously. Documentation was early, cheap, and plentiful. 
The developer program was free, and developers got excellent 
prices on equipment. Frankly, without those prices, I don’t 
know that I would ever have been able to afford to join in the 
fun. Developers formed a sense of community and 
camaraderie, and some energetic souls at Apple found lots of 
ways to encourage us along the way. Some even went way out 
of their way to seed young, unproven college kids with an 
alpha version of MPW (thanks Technostud!), building a sense of 
excitement that led to me losing so much sleep that I started 
having those dreams where I find myself realizing that I have a 
final exam and I forgot to attend any of the classes (oh, come 
on now, admit it - you’ve had these, too, right?). 


THE MACINTOSH WAY 
Coolness. That’s what drew me to the Macintosh. The product, 
the company, the community, and the vast possibilities, all built 
up coolness. 

OK, so that’s how many of us got into this business. Now 
we're surrounded by “realists”, nay-sayers who would tell us 
that we're wasting our time on the Macintosh. Now, you might 
suspect that I’d say one of two things. For one, I might say, 
“Defend the Macintosh at all costs. We’re too deeply vested to 
turn back now.” On the other hand, I might say, “Look, 
Windows has won, Apple has lost, and the Macintosh can’t ever 
catch up, so why fight it. Go where the market is.” 

Well, I won't say either one of those things. Remember 
why I got into this business? Coolness. I trusted my gut 
instincts and went where the action was. While I’ve never 
believed that Apple had an exclusive on coolness (in fact, they 
lately seem to have discovered a wellspring of “interesting” 
behavior that challenges their innate coolness), I’ve taken 
Apple’s coolness for granted for years. 

What’s my take on all this then? Simple. Go for the 
coolness. Macintosh offers lots of it, and a whole host of 
Macintosh developers couldn’t ever exhaust the possibilities. By 
the same token, coolness lurks in other places, too. 

“Going to the coolness” suggests that coolness always 
comes from somewhere else. Let me suggest this — in the quest 
for coolness, sometimes you may simply have to take the 
coolness with you, and that applies whether you’re exploring a 
new platform, or unearthing new treasures on an old favorite. 
That’s the Macintosh Way. 


Continued on page 71 
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Each year, the illegal use of software 
consumes nearly 50% of your potential 
revenues. With the flames of piracy eating 
away at your profits, can you afford not to 
protect your software? 


Software Obtained Illegally, by region, 1993 vs. 1994 
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Latin America 

$2,487,360,944 
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U.S./Canada 


$12,840,204,124 


Total for 1994: $15,212,700,215 Source: BSA 





MacHASP® is widely acclaimed as the world’s 
most advanced software protection solution 
for Macintosh computers. Since 1984, 
thousands of leading Mac and PC developers 
have used over one million MacHASP and 
HASP keys to protect billions of dollars worth 
of software. Why? Because MacHASP’s 
security, reliability, and ease-of-use led them 
to a simple conclusion: MacHASP is the most 
effective software protection system available. 





Today, more developers are choosing 
MacHASP than any other software protection 
method. To learn why, and to see how easily 
you can increase your revenues, call now to 
order your MacHASP Developer’s Kit. 


1-800-223-4277 


The Professional's Choice 


North Aladdin Software Security Inc. 
America Tel: (800) 223 4277, 212-564 5678 
Fax: 212-564 3377 
E-mail: sales@hasp.com 
WWW: http://www.hasp.com/ 


Intl Office Aladdin Knowledge Systems Ltd. 
Tel: 972-3-537 5795, Fax: 972-3-537 5796 


VISIT OUR WEB SITE E-mail: aladdin @aladdin.co.il 


http://www.hasp.com/ United Aladdin Knowledge 
Kingdom Systems UK Ltd. 
Tel: 01753-62226, Fax: 01753-622262 


France Aladdin France SA 
Tel: 1 40 85 98 85, Fax: 1 41 21 90 56 









of their respective manufacrurers. Mac & the Mac OS logo 
are trademarks of Apple Computer, Inc., used under license 





© Aladdin Knowledge Systems Ltd. 1985-1995 (6.95) HASP@ is a registered trademark of Aladdin Knowledge Systems Ltd. All other product names are 





iieraber oF 0088 Aladdin Benelux 08894 19777 » Aladdin Japan 0426 60 7191 m Aladdin Russia 095 9230588 m Australia Conlab 3 8985685 = Czech Atlas 2 766085 
tec Chile Micrologica 2 222 1388 # Denmark Berendsen 39 577300 w= Egypt Zeineldein 2 3604632 m Finland ID-Systems 0 870 3520 = Germany CSS 201 278804 
eda: Greece Unibrain 1 6856320 w India Solutions 11 2218254 w Waly Partner Data 2 26147380 m Korea Dae-A 2 848 4481 m Mexico SiSoft 5 5439770 


MICROSOFT 


WINDOWS .« Mac’ QS New Zealand Training 4 5666014 Poland Systherm 61 480273 Portugal Futurmatica 1 4116269 Romania Interactiv 64 153112 


ii = Itrunswith $= [LEG 
COMPATIBLE South Africa D Le Roux 11 886 4704 » Spain PC Hardware 3 4493193 m Switzerland Opag 61 7169222 m Taiwan Teco 2 555 9676 Turkey Mikrobeta 312 467 7504 


NetWare ;lubiaaw 


Developer tested only for ON2 





f 


\ 
\ 





Cross-Platform Object Database Engine 
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Powerful 

NeoAccess and NeoShare are the most ee | 
object-oriented database engines available. They 
display electrifying performance—up to ten 
times that of competitors. Behind an elegant 
programming interface is a high performance 
query engine utilizing: extended binary trees 
and binary search algorithms tuned for short 
access times, dynamically combined, collapsed, 
and compressed indices, and a caching for 
lightning fast access to previously used objects. 


No Runtime Fees 

Get the power of NeoAccess and NeoShare, and 
avoid the expense and administrative hassle of 
feeding the runtime fees meter. You pay one 
affordable price no matter how many copies of 
your application you sell or use. | 
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Scalable 


NeoShare extends the core features of 
NeoAccess to client/server applications. 
NeoShare includes the NeoAccess Toolkit and 
everything you need to create data intensive 
distributed applications. Its advanced 
client/server architecture provides shared access 
to objects by multiple networked clients. 
Combine client and server functions into a 
single application or create separate client and 
server applications. With NeoShare you have 
complete flexibility in the design of your 
distributed systems. 


Power Too Abundant to Meter 


Cross Platform 

Others may promise cross-platform 
development tools—NeoLogic delivers. 
NeoAccess is a set of C++ classes designed for 
use with popular compilers and application 
frameworks on Windows®, Macintosh®, and 
Unix™ platforms. Full source code is included 
so it can even be used with custom frameworks. 


New in NeoAccess Version 4.0 
NeoAccess now supports Microsoft Visual C++ 
4.0 IDE, MFC 4.0 and the latest version of 
Metrowerks CodeWarrior. A new stored query 
class increases speed and flexibility in accessing 
objects. Taverted: indices and full word search 
oe ease working with many-to-many 
relationships. And all new on-line Hyper- 
Reference guide, documentation, tutorial, and 
sample applications get you up to speed quickly 
and provide a complete set of reference material. 





Proven 

Thousands of commercial and in-house 
developers have already found that NeoLogic’s 
technology enabled them to build fast, 
powerful applications in record time. That’s 
why NeoAccess and NeoShare based 
oe are already operating on millions 
ol computers. Tap into the power for your next 
development project! 


neoslogic’ 


Powering Development of Object-Oriented Applications 
NeoLogic Systems 1450 Fourth St., Suite12 vv. 510.524.5897 
neologic@neologic.com Berkeley, CA 94710 f. 510.524.4501 




















By Dave Mark, MacTech Magazine Regular Contributing Author 


Last month, we implemented a window 
containing a scrolling TextEdit view. 
Though you could type text in a 
window, there was no way of saving the 
text out as a file or of loading a text file 
into a text editing window. What’s 
missing here is the concept of a 
document. PowerPlant features a 
sophisticated set of document-handling 
classes that allow you to quickly tie a 
file to a window. Each file/window 
pairing is known as a document. 
Although PowerPlant does support a 
more complex model (multiple windows 
tied to a single file, for example), the 
most common document approach ties a 
single file to a single window, all 
controlled by the LSingleDoc class. 

This month, we’re going to 
examine a sample application that ships 
with CodeWarrior. The application is 
called DocDemo, and it implements a 
simple TextEdit window that supports 
most standard document behaviour. 
That is, you can Save a document, 
Save As... under anew name, Open 
an existing document, and Print a 
document. DocDemo supports Apple 
events and is recordable. You can find 
DocDemo on the CodeWarrior CD. On 
CodeWarrior 8, it is in a folder called 
Document Demo. 

My original goal for this month’s 
column was to add the LSingleDoc 
class to last month’s program, allowing 
you to save your text window as a file 
and open an existing file in a text 
window. But when I saw DocDemo, I 
changed my mind. DocDemo does 
everything I wanted to do, but also adds 
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PowerPlant and Documents 


printing and great Apple event support. This is definitely a 
great learning program. Cool! 


GETTING STARTED WITH DOCDEMO 

Before you go any further, you might want to find a copy of 
DocDemo on your CodeWarrior disk (or download it from 
whatever site you go to to pick up the Getting Started source 
code each month [such as ftp://ftp.mactech.com/pub/src/ — man). 
Figure 1 shows the project window for the PowerPC version of 
DocDemo. Take a look at the files grouped under the name 
Application. The file CDocDemoApp.cp contains main () 
and the member functions that make up our main application 
class. CDocDemoApp is derived from LDocApplication, 
which is derived from LApplication. If you plan on 
building an application that supports multiple documents, 
CDocDemoApp.cp makes a great starting point. 

(Remember, a class that starts with “L” belongs to 
PowerPlant. All the classes that you add to your PowerPlant 
programs will start with “C”.) 


CTextDoc.cp 
CDirty Text .cp 
DocDemo-rsrc 
DocDemo .PPob 


.""ommanders | 19K . "BK . “st =] 
; "Panes SK . SFK re 
: s"Appie Events) 48K! 8K re 
i "Support . "28K SK re 


: Libraries al 





Figure 1. The DocDemoPPC.y._ project window 
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Where CDocDemoApp.cp implements the application, the 
file CTextDoc.cp implements a single text-based document. 
CTextDoc is derived from LSingleDoc, which is derived 
from LDocument. 

CDirtyText.cp implements the actual text stream, the 
text stored in memory that appears in one of the DocDemo 
windows. The word “dirty” refers to the state of a text stream, 
either changed since the last save (dirty) or not. 

Later in the column we'll step through each of these three 
source code files, pointing out the highlights. The remaining 
three files in the Application group are resource files. Notice 
that the Constructor resources are stored separately from the 
rest of the resources. As mentioned in a previous column, this 
is a good idea. When you double-click on the file 
DocDemo.rsrc, your favorite resource editor is launched (in 
this case, the creator code of DocDemo.rsrc is set to launch 
Resorcerer — feel free to change it to use ResEdit if that’s your 
preference). When you double-click on the file 
DocDemo.PPob, Constructor is launched. 


= DocDemo.PPob S== 


Type : Marne 
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24 Text Printout 201 
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Figure 2. The main window for DocDemo.PPob 


Take some time to look through the resource files, 
especially the Constructor file. If you haven’t seen it yet, this 
would be an excellent time to check out Constructor 2.1, the 
version that shipped on CW8. It has a cool new look and a 
great new menu editor. Yup, Constructor now does menus! 
Figure 2 shows the main Constructor window for 
DocDemo.PPob. Very nice... 

The main view of interest here is the one named “Text 
Window”. If you double-click on it, you'll see something very 
similar to the scrolling text pane we created last month, with an 
LScroller enclosing an LTextEdit pane. Figure 3 shows the pane 
info window for the LTextEdit pane. Notice that the Pane ID is 
set to the four byte value 'Text' and that the Text ID 
checkbox is checked. When the Text ID checkbox is checked, 
the value in the Pane ID field is represented as a sequence of 4 
characters (like a resource type) instead of as a long integer. 

Notice also that the Class ID is set to the four byte value 
'Dtxt'. This value will come into play when we register our 
classes in the source code. We'll pass this value as a parameter 
to URegistrar::RegisterClass() in the CDocDemoApp 
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constructor. You'll see this in a bit, when we explore the 
project source code. 
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Figure 3. The LTextEdit pane info window for the pane 


RUNNING DOCDEMO 


Take some time to put DocDemo through its paces. The 
important things to test are the ability to save and reopen text 
files. If you have AppleScript installed on your machine (and 
you should), run the Script Editor, click the Record button, then 
run DocDemo. While recording, create a new window, type 
some text, then save the document to disk. Go back to the 
Script Editor and click the Stop button. Figure 4 shows the 
results when I did this on my Mac. The line saying “make new 
document” was a result of selecting New from the File menu. 
The line following it was a result of doing a Save. Notice that 
the action of typing my text was not recorded. Once you've 
been through the code, see if you can figure out why this 
action wasn't captured and how to make this happen. 


= untitled 


tell application “DocDemoPPC" 
activate 
make new document 
save document “untitled” in file “Macintosh HD:Desktop Folder:Test 1 .txt" 
quit 
end tell 


AppleScript |G} 


Figure 4. A script recorded using Script Editor 
while running DocDemoPPC 
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Why so many developers are switching to 
MicroGuard copy protection 


@ MicroGuard is committed to uncompromising © @ MicroGuard has now surpassed its own 


technological superiority technological lead, actually improving on the best 
"Technology at its peak" is our commitment to you. That is why we have MicroGuard Plus is everything MicroGuard is, plus 40-bit encryption, two 
brought you MicroGuard Plus™. And, MicroGuard Plus is 100% additional passwords, 64-Bit Array, 32-byte public area, 45% size reduction, 
backwards compatible with MicroGuard. This means MicroGuard enhanced counter and more. In addition, MicroGuard Plus offers two new 

and MicroGuard Plus can be used interchangeably. utilities: QuickGuard™ and EasyGuard™ allow you to protect your 


applications without touching your _ 
source ode. The only feature that 
is pot bs is|the price. :-) 

| 


Just as we promised! 





@ MicroGuard offers you the 
most sophisticated network 
protection 


Our network protection, MicroGuard Net™, 
is so superior, we had to hire an Apple network 
engineer to execute our specifications. 


@ MicroGuard is the best 
selling Macintosh key in 
the world 


MicroGuard sells more Macintosh 
copy-protection keys than anyone else 
in the world! 





@ MicroGuard is the only key 





developed by Mac ® MicroGuard delivers 
developers, and is the first developer support 
and only 100% ADB savvy key within 24 hours 

We have been developing Mac applications as a seed development house We will answer any inquiry you have within 24-hours. We also have a fully loaded 
since 1984. We are not a PC protection company that has come to you AppleLink bulletin board which contains all our libraries, tech notes, Q&A and 
with a Mac product. MicroGuard is fully ADB savvy and offers extended nearly everything you'll ever need! 


addressing. Unlike other protection devices, MicroGuard never clashes 
with other keys. Only MicroGuard offers this level of sophistication. 







(actual size) 


For more information and to order a Developer's Kit or to receive a free CD ROM about M. icroGuard, 
please contact us at: 





MicroGuard USA: Tel: (303) 320-1628 ® Fax: (303) 320-1599 *_AppleLink: M.GUARD : 
International: Tel: (972) 3 558-2345 * Fax: (972) 3 558-2344 ° AppleLink: MICROGUARD MacOS 


Pirate Busters 





Here’s another interesting thing to try. You may 
experience an unrecoverable crash with this one, so be sure 
you save any open docs first! In DocDemo, open a new 
window, type some text, then save the document on your hard 
drive. Without closing the window, select Open from the File 
menu. Select the file you just saved (it’s already open, right?) 
from the SFGetFile list, then sit back and watch some exception 
handling kick in. Remember that option-8-escape forces a 
quit; you might end up using it. You might want to repeat this 
experiment with the debugger turned on. 

OK, enough play. Let’s check out the source code. 


CDocDEMOAPP.CP 

You'll notice a strong similarity between CDocDemoApp and 
last month’s PPTextEdit.cp file. While PPTextEdit’s 
application class, CPPStarterApp, was derived from 
LApplication, CDocDemoApp is derived from 
LDocApplication (LDocApplication is derived from 
LApplication). Here are some important things to look at 
as you go through the source in CDocDemoApp.cp: 


e CDocDemoApp overrides OpenDocument (), MakeNew- 
Document (), ChooseDocument(), ObeyCommand(), 
and FindCommandStatus(). ObeyCommand() and 
FindCommandStatus() should be familiar to you from 
previous columns. In DocDemo, they don’t do much, since 
we haven't added any commands specific to DocDemo. 


¢ OpenDocument () gets called on an 'odoc' Apple event 
and opens the file specified in the incoming FSSpec. In a 
truly recordable application, OpenDocument () should never 
be called directly. When you want to do an open, you should 
post an 'odoc' event, which will cause OpenDocument () 
to get called. Remember, Apple events are what get recorded. 
Without the Apple event, the process of opening a document 
won't be recorded. To post an 'odoc' Apple event, call 
LDocApplication: :SendAEOpenDoc(). 


e MakeNewDocument() gets called in response to a 
kAECreateElement Apple event. When you select New 
fom the File menu, PowerPlant sends itself a 
kAECreateElement Apple event. Again, this is vital if you 
want your app to be recordable. To see this in action, take a 
look in CDocDemoApp::ObeyCommand(). Notice that 
cmd_New is not handled and that this causes a call of 
LDocApplication::0ObeyCommand(). 
LDocApplication::ObeyCommand() sends the 
kKAECreateElement Apple event in response to cmd_New. 
MakeNewDocument () uses new to create a new CTextDoc. 


e Take a look at the ChooseDocument() source code: 


void 
CDocDemoApp: : ChooseDocument () 
{ 
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StandardFileReply macFileReply; 
SFTypeList typeList; 


UDesktop: :Deactivate(); 
typeList[0] = 'TEXT'; 
::StandardGetFile(nil, 1, typeList, &macFileReply) ; 
UDesktop: :Activate(); 
if (macFileReply.sfGood) { 
OpenDocument (&macFileReply.sfFile) ; 


There are a couple of interesting points here. First, notice 
that ChooseDocument () calls OpenDocument () directly. 
This action will now not be recordable (try it). Instead, 
ChooseDocument should pass macFileReply.sfFile 
to LDocApplication: :SendAEOpenDoc(). 


UDesktop: :Deactivate() calls Deactivate() for every 
window object in your app. This is needed since 
StandardGetFile() eats all the events as soon as it is 
called and your application windows never get a chance to get 
deactivated. If you don’t call UDesktop: :Deactivate(), 
then when the StandardGetFile() dialog appears, your 
previously frontmost window will still appear in its active 
state (the title bar will still have stripes, for example). This 
is purely for aesthetics. 


UDesktop::Activate() calls FrontWindow() and calls 
that window’s Activate(), returning things to the way 
they were before the call to UDesktop: :Deactivate(). 


Note: If you have floating windows in your application, 
replace the file UDesktop.cp in your project window with 
UFloatingDesktop.cp. UFloatingDesktop.cp uses a 
slightly different mechanism for activate/deactivate that takes 
floating windows into account. This file is a little bigger and 
causes your built app to be a little larger, so don’t make the 
switch unless you use floating windows. 


Take a look at the call of ::StandardGetFile() in 
ChooseDocument(). The two colons before the function 
name tell the compiler that the function is a global function. 
By convention, we always put two colons in front of a 
direct Toolbox call; this helps us discriminate between 
Toolbox and member function calls. 


e ObeyCommand() and FindCommandStatus() don’t do 
much here. You'll want to add stuff to these functions as 
you add commands and menus to your own applications. 


e Take a look at the other member functions in 
LDocApplication (the ones we didn’t override). They 
are mostly there to handle Apple events and printing, and 
are definitely worth reviewing, especially if you are trying to 
learn how to work with Apple events. 
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Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 


“A distinct improvement over ResEdit.” 
— MacTech /MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


“Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
— Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 
— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“..a wealth of time-saving tools.” 
MacUser Review, Dec. 1992 


RESORCERER 
Version 1.2.4 The Resource Editor for the Macintosh Wizard 


ORDERING INFO e New ‘cicn’, ‘ppat’, ‘ersr’, ‘acur’, ‘pitt’, ‘clut’ editors 
¢ Powerful icon family editing (all 9 icon types) 

| ¢ Color pixel anti-aliasing, dithering, and lots more 

Needs: >Mac Plus, > Sys 4.2, IMB ¢ Complete ‘PICT’ disassembly and reassembly 

Likes: >Mac Plus, > Sys 7.0, 2MB New 1.2 Features: ¢ er egmae see Fi ROM papaaiy browsing ed 
hi ° emplate field parsing types now supporte 

ee ¢ New insertion & deletion template field types 

¢ Text-only ‘PICT’ resources 


Price: $256 (decimal) ¢ Lots of improvements throughout 


(Educational, quantity, or 


other discounts available) e Easier, faster, more Mac-like, and more productive than ResEdit 


e Safer memory-based, not disk-file-based, design and operation 


Includes: 500 page manual e All file information and common commands in one easy-to-use window 
60-day Money-Back Guarantee ¢ Compares resource files, and even edits your data forks as well 
Domestic UPS ground shipping e Visible, accumulating, editable scrap 

e Searches and opens/marks/selects resources by text content 


. ¢ Makes global resource ID or type changes easily and safely 
le a ae ¢ Builds resource files from simple Rez-like scripts 
| ¢ Most editors DeRez directly to the clipboard 
e All graphic editors support screen-copying or partial screen-copying 
¢ Hot-linking Value Converter for editing 32 bits in a dozen formats 
¢ Its own 32-bit List Mgr can open and edit very large data structures 
e Templates can pre- and post-process any arbitrary data structure 
¢ Includes nearly 200 templates for common system resources 
¢ TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 


Extras (call us): 
COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demos/Updaters: Q 
AppleLink: Software Sampler e Full integrated support for editing color dialogs and menus 
AOL: Software Libs/Development ¢ Try out balloons, ‘ictb’s, lists and popups, even create C source code 


e Integrated single-window Hex/Code Editor, with patching, searching 
¢ Editors for cursors, versions, pictures, bundles, and lots more 

¢ Well-designed, helpful developer tools being added all the time 

¢ Relied on by thousands of Macintosh developers around the world 


CompuServe: MACDEV/Tools 
or call us. 





MATHEMASTHETICS, INC. 
P.O. Box 298 © Boulder * CO ® 80306-0298 * USA 
Phone: (803) 440-0707 © Fax: (303) 440-0504 
AppleLink/AmericaOnline: RESORCERER ° Internet: resorcerer@aol.com 


CTEXTDOC.cP 


CTextDoc is derived from LSingleDoc which is derived 
from LDocument. CTextDoc implements a single DocDemo 
document. Here are the highlights from the source code file: 


e CTextDoc overrides IsModified(), DoAESave(), 
DoSave(), DoRevert(), and DoPrint(). 


e Take a look at the function CDocDemoApp: :0Open- 
Document (): 


void 
CDocDemoApp: : OpenDocument ( 
FSSpec *inMacFSSpec) 
{ 
CTextDoc *theDoc = new CTextDoc(this, inMacFSSpec) ; 
} 


Notice that this code causes the CTextDoc constructor to be 
called. The CTextDoc constructor calls CreateWindow () 
to create a new window, passing it the 'PPob' resource ID 
200 as a parameter. Here’s the constructor: 
CTextDoc: :CTextDoc ( 

LCommander *inSuper, 


FSSpec *inFileSpec) 
: LSingleDoc (inSuper) 


// Create window for our document 
mWindow = LWindow::CreateWindow(WIND TextDoc, this); 


// Specify that the text view should 

// be the Target when the Window 

// is activated 
mTextView = (CDirtyText*) mWindow->FindPaneByID('Text'); 
mWindow->SetLatentSub (mTextView) ; 


if (inFileSpec == nil) { 


NameNewDoc () ; // Set name of untitled window 
} else { 
OpenFile(*inFileSpec);  // Display contents of file in window 


} 


The call to FindPaneByID() returns a pointer to the 
LTextEdit pane object. The call to SetLatentSub() tells 
PowerPlant that the LTextEdit pane should be the target 
when the window is activated. Without this call, the text edit 
field would not become active when the window was 
activated, and the text insertion cursor would not flash (or 
even appear) until you clicked on the text edit pane. If you 
go back to last month’s example, you'll see that that is exactly 
what happened. Take a few minutes, open up last month’s 
program, and see if you can add the code that makes the text 
cursor blink as soon as a new window is created. 


¢ NameNewDoc() makes use of a pair of strings to name the 
new document “Untitled” or “Untitled x”. If there is no 
window named “Untitled”, NameNewDoc() makes that the 
new window name. If there already is a window named 
“Untitled”, NameNewDoc() looks for a window named 
“Untitled 1”, then “Untitled 2”, etc. As soon as it finds an 
open slot, that becomes the name of the new window. 
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Here’s the code: 


void 
CTextDoc: :NameNewDoc () 


[ 
l 


// Start with the default name (“untitled”) 
Str255 name; 
::GetIndString(name, STRx_Untitled, 1); 


long num = 04 
while (UWindows::FindNamedWindow(name) != nil) { 


// An existing window has the current name 
// Increment counter and try again 


::GetIndString(name, STRx_Untitled, 2); 
numt+ ; 

Str15 numStr; 

::NumToString(num, numStr); 
LString::AppendPStr(name, numStr) ; 


mWindow->SetDescriptor (name) ; 


The first call to ::GetIndString() returns the string 
“Untitled”. The second call returns the string “Untitled ” 
(note the space at the end of the string). 


The call to mnWindow->SetDescriptor() sets the 
window’s title. Don’t be fooled. SetDescriptor() has 
nothing to do with Apple event descriptors. Greg used the 
function name SetDescriptor() any time you were 
setting the title of an object to a value. 


Here’s the code to CTextDoc: :OpenFile(): 


void 
CTextDoc: :OpenFile( 
FSSpec &inFileSpec) 
{ 
Try_ { 
mFile = new LFile(inFileSpec) ; 
mFile->OpenDataFork(fsRdWrPerm) ; 
Handle textH = mFile->ReadDataFork(); 
mTextView->SetTextHandle(textH) ; 
::DisposeHandle(textH) ; 


mWindow->SetDescriptor(inFileSpec.name) ; 
mIisSpecified = true; 


Catch _(inErr) { 
delete this; 
Throw_(inErr): 


} EndCatch_ 
} 


Try_ is a macro Greg wrote to simulate exception handling 
before CodeWarrior supported exception handling. Now 
that exception handling is supported, Try_ is just defined 
as try and Catch_ is just defined as catch. 


You will definitely want to spend some time curled up with a 
good book or paper on exception handling. Basically, here’s 
how this works. The try keyword tells the compiler to 
execute the block of code that follows the try. If the 
function throw() is called anywhere within that block 
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| For Windows. 95 AND Windows NT.. WORKSTATION 





Add-On for 
Macintosh 
and Power 
Macintosn 


Bring out the best in both worlds. 


Using just one toolset to target multiple platforms, you can 
increase your user base and knock months off your develop- 
ment time. With Microsoft® Visual C++" Cross-Development 
Edition for the Macintosh*, you can reuse up to 90% of your 
code from your Windows-based applications to create the 
same applications for the Macintosh®, with the familiar 
Macintosh interface. 


Features Include: 

m Port Windows®based features easily to the Macintosh, 
including multiple document interface, print preview, and floating 
toolbars. The Windows Portability Library does the work for you. 
M@ 7rue native Macintosh programming. Program directly to 
the System 7 API to take advantage of unique Macintosh fea- 
tures such as Publish and Subscribe. 

™ Recompile for the Mac™: Target both the Windows and 
Macintosh operating systems using just one set of source 
code written to Microsoft Foundation Classes and the 
Microsoft Win32® API. 


*This add-on toolset requires Visual C++ for Intel® platforms, available separately. 


M Power Macintosh™ Support: \Including a fully optimizing 
compiler and integrated debugger that adapts to the 
PowerPC™ chip when displaying information in the register 
contents and disassembly windows. 

i Code Fragment Support: for the Power Macintosh which 
translates to better code sharing among applications and 
faster, trimmer applications with very little development over- 
head. 

M@ OLE support: You can now easily port your Win32 and 
MFC OLE applications to the Macintosh using OLE for the 
Macintosh version 2.06. 

™ ODBC support: You can call ODBC directly or use it 
through the appropriate MFC classes. 
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Microsoft 
WHERE DO YOU WANT TO GO TODAY 


©1995 Microsoft Corporation. All rights reserved. Microsoft, Visual C++, Win32, Where do you want to go today?, and Windows are either registered trademarks or trademarks of Microsoft _ 
Corporation in the United States and/or other countries. Macintosh is a registered trademark and Power Macintosh is a trademark of Apple Computer, Inc., used under license. 
Mac is a trademark of Apple Computer, Inc. Intel is a registered trademark of Intel Corporation. PowerPC is a trademark of International Business Machines Corporation. 





(assuming there are no nested trys within the block), 
control is immediately transferred to the try’s matching 
catch block. The idea is, you can be way down in some 
code, encounter an error, and you jump out to the catch 
block attached to the code you are trying. The call to 
throw() is called, throwing an exception, and the catch 
block catches the exception. If the try code all runs without 
throwing an exception, the catch block is never entered. 


By the way, the data member mIsSpecified indicates 
whether an existing file is tied to this document. If it isn't, 
and we do a Save, we need to do a StandardPutFile() 
to create a new file. 


IsModified() tells you whether the document is dirty Gf 
you've made any changes to it since the last save): 


Boolean 
CTextDoc:: IsModified () 
{ 


mIsModified = mTextView->IsDirty() ; 
return mlsModified; 


} 

mIsModified indicates whether the document is dirty. 
Note that in this case, whenever the pane is dirty, the 
document will be dirty. But what if we had two text panes, 
both stored in the same document? mIsModified would 
be based on either of the panes being dirty. 


DoAESave() gets called in response to a kAESave Apple 
event 


void 

CTextDoc: : DoAESave ( 
FSSpec &inFileSpec, 
OSType inFileType) 
{ 
delete mFile; // Kill existing file 


mFile = new LFile(inFileSpec); // Make new file object 





OSType fileType = 'TEXT'; // Find proper file type 
if (inFileType != fileType_Default) { 

fileType = inFileType; 
} 

// Make new file on disk 
mFile->CreateNewDataFile(Creator DemoDoc, fileType, 0); 
mFile->OpenDataFork(fsRdWrPerm) ; 

DoSave(); // Write out data 
Oo // Change window name 
mWindow->SetDescriptor(inFileSpec.name) ; 
mIisSpecified = true; // Document now has a specified 
file 
} 


DoAESave() uses a pretty simple file-saving strategy. It 
deletes the existing file, then creates a brand new file and 
writes the text out to it. This strategy isn’t very good if your 
computer happens to crash between deleting the file and 
writing out the new contents. In that case, you lose 
everything. A better strategy is to create the new file first, 
then delete the old one. There is a tech note somewhere 
that tells you the exactly right (ie., official thought police) 
way to do this. 
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DoSave() is a utility routine that actually copies the text 
out to an existing file. 


void 
CTextDoc: :DoSave() 
{ 
// Get text and write to file 
Handle textH = mTextView->GetTextHandle(); 
StHandleLocker theLock(textH) ; 
mFile->WriteDataFork(*textH, GetHandleSize(textH)); 


mTextView->SetDirty (false) ; 
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// Saving makes doc un-dirty 


DoRevert() reloads the text from the file into the text 
pane and refreshes mText View: 


void 
CTextDoc: :DoRevert () 


Handle textH = mFile->ReadDataFork(); 
mTextView->SetTextHandle(textH) ; 

: :DisposeHandle(textH) ; 
mTextView->Refresh(); 
} 


DoPrint() does printing. We'll talk about that in a future 
column: 


void 
CTextDoc: :DoPrint() 
{ 


LPrintout *thePrintout = 

LPrintout: :CreatePrintout (prto_TextDoc) ; 
thePrintout->SetPrintRecord(mPrintRecordH) ; 
LPlaceHolder *textPlace = (LPlaceHolder’*) 
thePrintout ->FindPaneByID('TBox') ; 
textPlace->InstallOccupant (mTextView, atNone); 





thePrintout->DoPrintJob(); 
delete thePrintout; 
} 


CDiIrTYTEXT.cp 


CDirtyText is derived from LTextEdit which is derived 
from LView. It is basically a version of LTextEdit that keeps 
track of whether it is dirty or not. 


CDirtyText overrides SetTextPtr() and 


UserChangedText (). 


CDirtyText::CDirtyText() sets its dirty flag to 
false. 


CreateDirtyTextStream() is passed as a parameter to 
URegistrar::RegisterClass() Gin the CDocDemoApp 
constructor) and is what allows us to create a CDirtyText 
object from a 'PPob!: 


CDirtyText* 

CDirtyText: :CreateDirtyTextStream ( 
LStream *inStream) 

{ 
return (new CDirtyText(inStream) ); 
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e SetTextPtr() takes a pointer to a block of text and a 
length parameter and connects that block of text to this 
LTextEdit object: 
void 
CDirtyText: :SetTextPtr ( 


Ptr inTextP, 
Int32 inTextLen) 


LTextEdit: :SetTextPtr(inTextP, inTextLen); 


mIisDirty = false; 
} 


e UserChangedText() gets called whenever an action takes 
place on the LTextEdit view. If something has happened, if 
the pane is not already dirty, we have to change the menus 
to reflect the dirty status and flip the dirty flag. If the view 
is already dirty, we can’t make it any dirtier: 
void 
CDirtyText: :UserChangedText () 

{ 
if (!mIsDirty) { 


SetUpdateCommandStatus (true) ; 
misDirty = true; 
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e IsDirty() just returns the status of the dirty flag. 


e SetDirty() sets the dirty flag. 


Tritt NEXT MONTH... 


DocDemo is one of the most interesting PowerPlant examples 
I’ve seen. It is incredibly rich without being too difficult to 
understand. There are a bunch of ways you can extend this 
app, so take some time and start playing. Try adding a few 
menus to the DocDemo. Use Constructor to change the word- 
wrapping of the LTextEdit field. Try to change the font, style, 
and color of the text displayed in each document. I'll see you 
next month... 





To receive information on any products 
advertised in this issue, 


send your request via Internet: 
productinfo@xplain.com 
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By Don Crabb 








Developers Finally Get a Break 


The last few months have been tough 
ones for the Mac developer community. 
As I am writing this, (1) Sun has made a 
bid to merge with Apple via a stock 
swap (a good thing, I hope it’s 
happened by now), (2) Apple has been 
pronounced dead by the know-nothing 
general press (if you ever thought 
BusinessWEEK would get a clue, you 
can forget it once and for all), (3) more 
than a thousand Apple employees have 
been let go (and while many needed 
letting go, badly, many were tight with 
developers), and (4) Apple lost its acting 
VP of Developer Relations, Shirley Stas. 

But the good news for us is that 
Shirley was replaced by Heidi Roizen, a 
name well known to the savvy 
developers out there, and as good a bit 
of news as we've had from the mother 
ship since Guy the K. was named Apple 
Fellow and Developer Evangelist last 
June. By now, Heidi’s tenure as the 
Vice President for Developer Relations 
should be well under way. 

Heidi’s philosophy, often practiced 
while the president of T/Maker, was that 
companies and individuals ought to help 
others in our industry and make as many 
friends as possible, especially when it 
can be done without compromising your 
beliefs. Heidi’s always believed that you 
should sow “good” seeds in every 
corner, because they'll often sprout later, 
just when you could use the return favor. 


The one negative from all this is that Shirley Stas, who’d 
been the acting VP for many months and who had done an 
excellent job, is now out of that job. Although she was not 
acknowledged by Apple in the press release for Heidi (and 
shame on Apple for this slight), Shirley has busted her hump to 
get DevRel back on track and reorganized following last June’s 
changes. I’m not sure what future role Shirley will have at Apple, 
but if Apple has a brain in its corporate head it will find the right 
place for her in the organization. Shirley’s not flashy, but she did 
right by developers and she should be rewarded for that. 


ALL HEIDI, ALL THE TIME 

Heidi Roizen should not be a new name to you. But in case it 
is, let’s give her record the once-over. She co-founded and ran 
T/Maker Company, one of the first Mac software developers 
(back when development was done in Object Pascal on a Lisa! 
— and we complain about our development environments 
today...). T/Maker shipped its first Macintosh title in February, 
1984, within a few weeks of the first Mac’s ship date. 

Besides running and eventually selling T/Maker, Heidi also 
has been the president and a board member of the Software 
Publishers Association, as well as a someone influential within 
the software marketing community. In short, Heidi understands 
both developer issues (she’s been there) and marketing issues 
(ditto). Since Developer Relations now includes all of the 
developer arms — Evangelism, Developer Support, Developer 
Marketing, Developer Press, Developer University, and 
International Developer Relations — Heidi’s got a reasonable 
organization to build from. And building is what she must do. 


DEVELOPER-DRIVEN EXCELLENCE 
Although Developer Relations cannot fix all the marketing and 
technical problems that Apple has suffered the last two years, it’s 
now poised to be what it should have always been — the key 
organization in the company. Apple has tried being a marketing 





Don Crabb — Don is a contributing editor and columnist for MacTech, MacWEEK, MacUSER, Mac/Chicago, Digital Chicago, 
MacToday, Win95User, ComputerUser, The Chicago Sun-Times Features Syndicate, The Springfield Union-News, PC Magazine, 
and about a million other publications. Don welcomes comments at his Internet address: don_crabb@mactech.com. You can 
also check out his WWW Home page at http://www.cs.uchicago.edu/~decc/. 
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WHY NOT USE THE BEST? 


Companies like Adobe, Claris, Symantec, Metrowerks, Netscape and hundreds of others 
recognize the unsurpassed quality of Developer VISE and have switched to MindVision for 
their installation needs. In fact, every day MindVision sells more installers than all other 
competitors combined. Don’t take our word for it. Ask any of our hundreds of satisfied 
customers why they switched from the competition to MindVision’s Developer VISE. 


We didn’t stop there. 
Announcing... 


INSTALLER VISE 4.0 


The New Industry Standard for Software Installers. 





Find, move, rename, or delete any file. Create hierarchical packages. Build one installer for 
multiple languages. Build installers with unparalleled ease. Attach AppleScripts to your 
installation. New archive features allow you to build CD-ROM installers quickly and easily. 

It may not slice and dice, but in addition to installing it also removes. And much, much more. 


And Introducing... 


UPDATER VISE I.! 


The Most Advanced Updater Available. 


Updater VISE is the only product that can update multiple versions of your 68K, PowerPC, 
and Fat application from ONE updater. Updaters are extremely compact and totally secure, 
allowing for easy online distribution. And, combined with Installer VISE you can update any 
number of different files giving you a total software delivery solution. 





Maybe it’s time to stop and take a look at MindVision’s software delivery solutions. 
Visit our web site for full information, 
including fully-functional demos. 


WWW. InNniIndvision.com 


Email: info@mindvision.com * Voice: (402) 477-3269 * Fax: (402) 477-1395 








SOFTWARE 
DELIVERY 
SYSTEM 






MindVision 
Software 


© 1996 MindVision Software. All Rights Reserved. Developer VISE, Installer VISE, and Updater VISE are trademarks of MindVision Software. 











OFILE 


PowerPlant 


integrated closer than any other database 


AppMaker 


complete database application generation 


HTML 


report-writer built into database 





No Stream Methods 


No PreProcessor 
No Fuss 


dent@highway1.com.au 
CompuServe: 100033, 3241 
http://www. highway 1.com.au/adsoftware/ 


demo’s on CodeWarrior & AppMaker CD’s 


royalty-free, full source, priced from $900 inc. c-tree 


the cross-platform OODBMS that speaks c++” 











driven company and bombed. It has tried being a technically 
driven company and bombed. Perhaps it’s time Apple tries 
being a developer-driven company? Ultimately, it’s Apple 
developers (for MacOS and whatever comes after it) who will 
put the company back into the good graces of customers and 
help dispell the doom-and-gloom “analyses” of the general press. 

But for Apple to become developer-driven, it’s going to 
have to trust us more than it’s ever been willing to. It’s got to 
get us on board much faster when it comes to new 
technologies. We should have been pre-alpha testing Copland, 
for example, in large numbers, and with our input really being 
parsed, instead of waiting for our DR1s to dribble in only to the 
biggest developers. 

Apple needs to start using us as a resource, not as a 
revenue source. Apple needs to develop the right mechanisms 
by which we can be made part of the extended internal 
developer teams for all key Apple technologies. I can imagine 
what might have happened with important Apple technologies, 
like AppleScript and PowerTalk, if only the right developers 
had been brought onto the teams with real authority. 

Had AppleScript, for example, been developed and 
marketed with the likes of Cal Simone (of Main Event Software 
and its Scripter) on the team, and with real access to the product 
marketeers, we wouldn’t be wondering today why Apple had 
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squandered its lead in user scripting. Or why we have to wait 
for Copland before we get a native version of AppleScript. You 
can go down the list of Apple core technologies over the past 
several years and make similar cases. 

Heidi is ideally positioned to address issues like this. 
Coming to Apple as an influential outsider, she sees the benefit 
of having other influential outsiders (who also bleed six colors) 
as part of Apple’s extended family. And with her outside track 
record she should have the clout to get a good hearing for 
these sorts of developer partnerships from Dave Nagel. 


BATTLES AND WARS 
But we won't win all of what we want, and while Heidi will get 
Apple to open up and embrace us earlier and more often, we'll 
have to pick and choose our top needs, some of which I’ve 
listed here for Heidi’s perusal: 


¢ Make entry-level developer support free, to encourage more 
Generation-Xers to develop on the Mac. 


e Lower the prices for all other developer support levels and 
increase each level’s exposure to Apple engineers. 


¢ Cut the price of developer tools to the bone. Sell ’em for 
cost if necessary. 


¢ Work with MetroWerks and your other tool vendors to 
help develop tools for differentiating our common code 
base products across platforms (MacOS, Newton OS. 
Pippin OS, etc.). 


e Partner with your MacOS cloners to provide entry to the 
Apple developers program through them. 


e Start now on the next generation of developer tools that will 
be operational in ten years. 


And this list just scratches the surface of what Developer 
Relations under Heidi Roizen should be able to provide us. A 
good test for how much we can expect and how fast (and how 
much of the old Apple corporatespeak we'll have to endure) 
will come in a month at WWDC 96. See ya there. 





Visit MacTech Magazine’s Web site! 


Nttp://www.mactech.com 
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You Can’t Wait Forever. 





Let’s Face It. 


As a professional developer or webmaster, 
you have to think of yourself first. You have 
deadlines to meet, products to deliver, and 
people depending on you. 


A Tool in Hand... 


Your tools are your livelihood. You need up- 
to-date technologies and timely support. You 
can’t afford to wait for vaporware to material- 
ize or for your tools vendor to leisurely add 
features that you need today. 


When Hell Freezes Over? 


When was your text editor last updated? Six 
months? A year? Five years? And when you 
contact the vendor that produced it, do they 
tell you how they’re working on the next great 
version, how wonderful it’s going to be, and 
how it will ship “Real Soon Now”? Or worse 
yet, do you get a disconnected phone number? 


That’s where we come in. 


At Bare Bones Software, we deliver the best 
tools here and now. We have a distinguished 
tradition of continually enhancing the function- 
ality, performance, and design of our products 
to meet our customers’ needs. We don’t allow 
our products to languish until we feel like doing 
something about it. We won’t hype vaporware 
as the solution to today’s problems. And we 
haven't drifted in and out business on a whim. 
We're here to support you for the long haul. 


Bare Bones Software, Inc. 
P.O. Box 1048 
Bedford, MA 01730-1048 USA 


Voice: (508) 651-3561 
Fax: (508) 651-7584 
E-mail: bbsw@netcom.com 


Bare Bones ; 
Software, Inc. Web: _ http://www.tiac.net/biz/bbsw / 





What About the Software? 


You don’t have to wait for the software, either. 
We’re constantly refining our techniques and 
technology to bring you the fastest and most 
efficient tools. As the result of our efforts, 
BBEdit has repeatedly raised the standard for 
Macintosh text editing. (In fact, we’ve done so 
many cool things, several of our competitors 
have tried to copy us. Imitation is the sincerest 
form of flattery, after all. We’re very flattered.) 


Why Believe Us? 


Since its commercial debut in 1993, BBEdit has 
set the pace for capability, user-interface, 
functionality, and customer support that others 
have yet to match. BBEdit was the first text 
editor to support ToolServer, THINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, 
Internet Config, Quickdraw GX printing, 
PowerTalk, PowerPC acceleration, AppleScript, 
Apple Guide, and Macintosh Drag and Drop. 
We're still setting the pace for others to follow, 
as the only Macintosh text editor to integrate 
directly with Metrowerks CodeWarrior, through 
the use of the ClickWarrior extension. 


See for Yourself. 


We've painted a great picture, but don’t take 
our word for it. Visit our Web site and see for 
yourself. You'll find lots of things to like. 


BBEdit. Because you 
can’t wait forever. 








@ 
Accelerated for 
Power Macintosh 





BMUG 


Choice Product 
FALL 1995 


Ma 





Our lawyers insist we say: BBEdit and our spiffy logo are trademarks of Bare Bones Software, Inc. Mac and the MacOS logo are trademarks of Apple 
Computer, Inc., used under license. PowerPC is a trademark of International Business Machines Corporation. All other trademarks and registered trademarks 
are properties of their respective holders. Bare Bones Software, Inc. products are cruelty free (except for a few beta testers). © 1996 Bare Bones Software, Inc. 
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By Andy McFarland, Symantec Technical Support SYMANTEC ° 








This monthly column, Override GetFrom() if you need to use information from 


, 9 the VA resource file in your intitialization. For instance, a 
writen by Sy mantec's Rect frameRect might be used to save you from having 


Technical Support to use the LongToQDRect() macro in toolbox calls that 


Engineers, is intended require a Rect. It is perfectly valid (and may be simpler) to 
to give our readers put all of your construction/initialization code into 


: : ; GetFrom(), and not write a constructor at all. 
technical information on 


using Symantec products. Q: VA conveniently creates Save and Savefs... file menu 
items. What do I actually have to do to save my document 
to a file? 
Q: I have written a constructor for my 
CPanorama derived class so I can A: CDocument has a data member itsFile, a CFile*, which 
pass some specific initial values, but will point to whatever species of CFile you actually create, 
now all the parts of the object I such as CDatafile, CResFile or CPictFile, etc. 
specified in the Visual Architect are 
coming up NULL or garbage. What’s The Save As... menu item is connected to CDocument:: 
going on? DoSaveFileAs(). PickFileName() is called from 
there, which puts up a StandardPutFile() dialog to 
A: When it comes time to instantiate a retrieve the vitals of the file-to-be in an SFRep1y record. 
class created in Visual Architect, a 
TCL macro new_by_name is used. Finally, DoSaveFileAs() passes the SFReply record to 
It calls a (default) constructor if you DoSaveAs(), which is what you need to overide in your 
have written one, or simply an document class, ie. in CMain. At this point you need to 
implied (default-default) constructor allocate space for itsFile if you haven't already. 
if you have not. In either case, the 
information you specified in the VA is Now just use all the nifty methods inherited from CFile, 
read in from the resource file with CDataFile and perhaps CPictFile to do things like 
GetFrom() after all the constructors creating, opening, closing, reading and writing to the file 
in the inheritance chain for your class and changing its name. For simple file I/O, you may never 
have been called. have to call a File Manager routine directly. 
VA can call only default constructors. Q: I’m trying to use the TCL macro new_by_name() with a 
This includes constructors with no VA-generated class, but it’s not working. What’s up? 
parameters and those for which all 
the parameters have default values. A: At the beginning of the file you will see 
If you write a constructor that TCL_DEFINE_CLASS_M1(Cfoo,x_Cbar). This is the 
requires that at least one value be macro that makes the class an RTTI class (type “Run-Time 
passed, you will be creating an Type Identification” into THINK Reference for a full 
object separate from the one VA is explanation.) VA defaults to the M1 suffix, which must be 
going to create. You may still changed to D1 if new_by_name() is to be used. Note that 
initialize non-TCL members which most people will rarely, if ever, need to use new_by_name() 
may have been added to your VA- instead of TCL_NEW(). 
generated class either in the body of 
a default constructor or as parameters Q: Is it possible to create and use a routine descriptor for a 
with default values. member function? When I do so, the arguments are 


assigned in the wrong order. 
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Gives you the Information to Program your Best! 






“~ 


The Debugger V2 
& MacNosy 





by Steve Jasik, 


Information 


he Debugger is a low and high-level symbolic 

Debugger that runs in a full multi-window 

Macintosh environment. You can trace program exe- 
cution, view the values of variables, etc. of both 68K and 
PowerPC programs. 

MacNosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica- 
tion, resource file or the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.0x or System 7.x) environ- 
ment symbolically! 

It is the only debugger to use the MMU to protect your 
CODE resources and the rest of the system from the pro- 
gram you are debugging. With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe, 
Aldus, Claris, Electronic Arts, Kodak, Metrowerks, etc. 
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Control 


Its Features Include: 


® Symbolic Debugging of any Macintosh program, ROM, or 
code resource (DRVRs, XCMDs, INITs, PDEFs, 4DEXs ..) 


® Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, ...), and an Incremental 
Build System with instant Link for superfast development. 


® Object Inspector for MacApp 3 programs 
® Source level debugging of Think C™ projects 


® Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 


® Simultaneous Symbolic debugging of multiple “tasks” 


® Fast Software Watchpoint command to find clobbered 
variables 


® Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 


© Structured display of data (hypertext) with user definable 
structures while debugging 


® Conditional breakpoints to help filter out redundant 
information 


® Continuous Animated Step Mode to watch your program 
execute instruction by instruction 


® Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM, etc. 


® "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 


The Debugger V2 & MacNosy: $350 


Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 


Available from: Jasik, APDA, Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs + 343 Trenton Way, Menlo Park, California 94025 + (415) 322-1386 
Internet: macnosy@jasik.com ¢ Applelink: D1037 








You've spent 
enough 
time in 
development. 


Don't let your 
installer keep 
you from $Oing 


golden. 


Destination 

7 fa User Specified Folder 
3 User Specified Disk 
i) Startup Disk 
[|] Desktop 
[=] Active Apple Menu Items 

-| Active Control Panels 
Active Extensions 

Al Active Fonts 
==] Active Preferences 
(S] Active Startup Items 






Just because your 
software is done doesn’t 
mean your work is. You 
still have to write an 
installer. And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems’ proven 
installation standard, 
Stuffit InstallerMaker, * 
you can have your 
PowerMac® or 680x0 
product ready to ship 
literally within minutes, 
and save money to boot. 

Stuffit InstallerMaker 
uses our advanced 
compression technology 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit. Its menu- 
driven interface is so 
easy-to-use that even 


(5) Active System Folder your VP of Sales could 
prepare your installer. 
Condition New version 2.0.2 
Uersions 
passant adds full PowerMac 
System support, improved 
Display ° eye 
Processor a~ Any Processor scriptability, 
Custom Any 6800 
Gestalt... Any PowerPC and 
68000 expanded 






Options 

Minimum System... 
Startup Picture... 
Startup Text... 
installation Dialog... 
User Specified Folder... 
Progress Cursor... 
Warning Dialogs... 
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66020 or higher 680x0 


SINSTALLERMAKER 


localization, 
including German, 
French, and Japanese. 

To receive a free, 
fully-working copy of 
StuffIt InstallerMaker, 
call our licensing 
department today at 
(408) 761-6200. 





© 1994 Aladdin Systems, Inc. 165 Westridge Drive, 
Watsonville, CA 95076. Fax: (408) 761-6206. America 
Online, AppleLink: ALADDIN. Internet: 
aladdin@well.com. InstallerMaker is a trademark of 
Aladdin Systems, Inc. All other products are 
trademarks of their respective holders. 





: No. There are various problems involved. There are some 


implied parameters to member functions, like the this pointer 
(a pointer to the object). Further, the parameters are passed in a 
different order (Pascal style) but stack cleanup is done C-style. 


- I'm getting error -1708, “Couldn’t complete the last 


command because the AppleEvent was not handled”, when 
trying to build a library. 


: This usually results from the ToolServer not being installed 


properly. Check to be sure there is an alias for ToolServer 
in the (Tools) folder. Also, be sure to rename the alias as 
“ToolServer”. You may also need to copy the Toolserver 
folder from the CD, Apple Software:Tools: 
Toolserverl.1.1, to your hard drive. 


: How do I get the Standard Console to accept single 


keystrokes without a Carriage Return? 


: Use the csetmode() function. 


#include <stdlib.h> // For Constant EXIT_SUCCESS 
include <iostream.h> // For C++ I/O, cin and cout 
//#include <stdio.h> // If you use straight C I/O 


#Hinclude <console.h> // For cgetmode 
main() 
{ 
l 
char c; 
printf( "Type a character: "); 
csetmode(C_CBREAK, stdin) ; // Allow single key inputs 
c = getchar(); 
printf( "\nYou typed: '%c'", c, "\n" ); 


return 0; 
} 
J 


: When I bring my SPM project up to date, a Build Errors 


window shows up but is empty. What’s going on? 


- Your code is probably generating compiler warnings that 


you aren't seeing because the Build Errors window is set to 
hide them. Click on the Show Warnings button. 


- Can I use exception handling without the TCL? 


: To use exception handling without the Think Class Library, 


you must include BRLib and Exceptions.cp in your 
project. Also, you must compile with the directive: 


#tdefine NO TCL 


The four macros used to make exception handling work 
correctly are: 

AUTO_DESTRUCT_OBJECT 

TCL_NEW 


TCL_END_CONSTRUCTOR 
TCL_START_DESTRUCTOR 


The macro AUTO_DESTRUCT_OBJECT will guarantee that 
the destructor is called for an automatic object on the stack. 
A destructor will work only on a completely constructed 
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If you thought previous versions of QUED/M 
were powerful, wait until you program with 
QUED/M 2.7, loaded with these new pain- 


Of course, QUED/M 2.7 still has all the features 
that make it easier to use than any other text editor: 


relieving features: 


Integrated support for THINK Project 


Manager™ 6.0 & 7.0 


THINK™ debugger support 


CodeWarrior™ support (now it’s 
easier than ever to program for the 


Power Macintosh®!) 


MPW ToolServer™ support 


PopUpFuncs™ support 


TM 


Frontier 


For quick relief, call 
800-309-0355 today. 


Get even more relief: Try QUED/M 2.7 now for just $69! You'll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


QUED/M is a trademark of Paragon Concepts, Inc. All other products 
are trademarks or registered trademarks of their respective holders. 


object. TCL_END_CONSTRUCTOR helps the compiler to 
determine the complete construction of an object. 


See the example below to see how the macros are used. 


class funClass TCL AUTO DESTRUCT_OBJECT //macro in class header 
{ 


public: 
funClass() { // no arg constructor 
cout << "In constructor." << endl; 
char * myStr = new char[64]; = // allocate memory 


TCL_END_CONSTRUCTOR 
} 


// End of the constructor 


virtual ~funClass() { // virtual destructor 
TCL_START_DESTRUCTOR // Beginning of the destructor 
cout << "In destructor." < <endl; 


delete [] myStr; // deallocate memory 
} 5 


Q: Okay. I’ve done everything I’m supposed to do to use 
exception handling without the TCL, but I get a bunch of 
link errors when I try to use TCL_NEW. 


A: Rebuild BR_Lib.o with 


tdefine TCL_UNSAFE_ ALLOCATION. 


Q: Why does writing a text handle using CSaver cause 
garbage in the stream when I read it in? 
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Do Script support 


Austin, Scott Morison, and Mark Baldwin. 


«> Macro Language lets you automate 
tedious tasks 


Search and Replace through multiple 
unopened files and using GREP 
metacharacters 


File comparisons using GNU Diff 
Unlimited undos and redos 


10 Clipboards that can be edited, saved, 
and printed 


Customizable menu keys 
Text folding 
Display text as ASCII codes 


Plus many more features! 


sly 
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A: When you create an arbitrary length handle and then fill 


only part of it, the whole handle length is written (and then 
read) and so you end up with garbage. To get CSaver to 
work correctly with handles, you need either to create a 
handle the right size to begin with, or to resize it when 
assigning the text to it. As an example we will stream out a 
CEditText object. 


Within the myContents.cp file: 


// Don’t bother allocating space for the handle. 


In GetFrom(), stream in the text: 


stream >> myMainText; 


In PutTo(), stream out the handle and kill it: 


stream << myMainText; 
DisposHandle(myMainText) ; 


In CMain.cp::WindowToContents, construct the 


handle, and fill it: 


long len = fMain_Pano3->GetLength(); //get the length we want 

itsContents->myMainText = NewHandleCanFail( len ) 

BlockMove( *fMain_Pano3->GetTextHandle(), 
itsContents->myMainText, len ); 


Special thanks to Michael Hopkins, Craig Conner, Glenn 
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dth The Relational 
Database System 





te. 





When it comes to performance dtF is in a 
class all its own. dtF utilizes a proprietary 
query optimization and caching scheme to 
obtain unparalleled performance. If you are 
in need of a quantum leap in performance, 
use the dtF native PowerPC stand-alone or 
client/server version. 


performance 





Full transaction control and automatic level-3 error 
recovery guarantee maximum data protection even after 
sudden system crashes. dtF databases are compressed and 
encrypted to protect against all unauthorized access, even 
disk editors. Implement sophisticated table and operation 
level security with dtF’s password features. 





... data security 


With dtF’s unique direct integration technology, the dtF database system 
is fully contained in your application, enabling you to build double- 
clickable database applications. Never worry about missing or conflicting 
INIT's or drivers. dtF’s native API is compact, easy-to-use and integrates 
seamlessly with all major development environments on the Macintosh. 
dtF’s high performance SQL, integrated data dictionary, security 
features, automatic index selection, query optimization and error 
recovery allow you to concentrate on creating great database applications 
instead of messing around with the internals of the database system. 





**€8SC OF ce 


dtF is available for Macintosh System 7.x (68K and native PowerPC). 
dtF supports MPW C/C++, Symantec C/C++, Metrowerks CodeWarrior 
(all compilers 68K and native PPC). dtF is fully OpenDoc™ compatible. 


Stand-alone Separate versions for use with HyperCard 2.x, SuperCard 2.x, Smalltalk- 
: : : : Agents and Pictorius Peregrine are provided. AppleScript interface via 
a od lications built with DataScript™ for dtF from General Knowledge. dtF supports cross- 
dtF arer oyalty-free! platform development on Windows 3.11, Windows 95 and OS/2. 


dtF Americas, Inc. 
19672 Stevens Creek Blvd., Phone: (800) DTF-1790 


{ The Relational 





Suite 128 Fax: (510) 828-8755 , \ Database System 
Cupertino, CA 95014 AppleLink: DTEAMERICA | Ao ai siabeiiaisiniaisialsisiasisbslsiaaiaiaaiaaiaibtialedissiallaiallisliaeiiatal 
USA Internet: dtRamerica@ . 


applelink.apple.com 
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By Dave Mark 


A monthly column of 
assorted news, interviews, 
and technical information 
from Metrowerks. 


In this month’s Factory Floor, we'll meet 
Greg Dow. Greg designed and wrote 
PowerPlant, the next generation 
framework from Metrowerks. Before we 
get to the interview, I wanted to take a 
sec and thank Jim Trudeau for all his 
help in putting this interview together. 
Cognac and cigars on me at WWDC, Jim! 


Dave: Greg, since not all of our readers 
have a background in object 
programming, let’s start things off by 
defining a few terms. What is the 
difference between a class library 
and a framework? 


Greg: People often use the terms 
interchangeably. However, I think of 
a class library as a collection of 
utilities and a framework as a 
structure for building programs. 


With a class library, you are in 
control. You design the program 
structure and use library classes 
where convenient. For example, 
you can use the ANSI C++ streams 
class library to handle file I/O. 


With a framework, the framework is 
in control. You usually start with a 
“do nothing” program provided by 
the framework and add your own 
code. The framework calls your 
code at the appropriate time. 


PowerPlant is a framework, but it 


also has families of utility classes that 
you can use independently. 
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Dave: Why would a C programmer want to move to C++ and 


PowerPlant? What are the advantages? 


Greg: Using PowerPlant lets you build upon code written by 


other programmers. It’s code that you don’t have to write 
yourself. PowerPlant classes handle mundane tasks such as 
menu and window management, as well as more advanced 
features such as Apple events and threads. By not having to 
start from scratch, you have more time to concentrate on the 
unique features of your program. 


Another big advantage is Constructor, which lets you 
graphically lay out the visual elements of your PowerPlant 
programs. PowerPlant can create a window and its contents 
from information edited in Constructor, so it’s possible to 
create a program that displays items such as scrolling pictures, 
text, and buttons without ever writing a line of code. 


Dave: Once someone has learned the basics of C++ and object 


programming, how do they pick up on PowerPlant? 


Greg: The first thing everyone should do is read The 


PowerPlant Book, which is part of the Inside PowerPlant for 
CWS8 manual that comes with CW8. This book, written by 
Jim Trudeau, is an excellent guide to understanding and 
using PowerPlant. 


After that, they should start using PowerPlant. Look over 
the sample programs. Run the samples and use the source 
debugger to single-step through some of the code to follow 
the flow of control. For example, set a breakpoint in the 
main event loop, then hit a key and follow the resulting 
sequence of calls to see how PowerPlant handles it. 


Finally, talk with other people who use PowerPlant by 
getting a modem and an Internet account. Read the Usenet 
newsgroup comp.sys.mac.programmer.codewarrior. (A new 
group, comp.sys.oop.powerplant, will probably form soon.) 
Metrowerks also has an active forum on America Online. 
And join the PowerPlant Dream Team. 


Dave: What exactly is the PowerPlant Dream Team? What do 


they do? How do you go about joining? 


Greg: The PowerPlant Dream Team is an organization of 


developers interested in learning PowerPlant in a team- 
based environment. It started as a study group formed by 
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Stephen Jovanovic, but has grown to over 200 people. A 
small subset of the PP Dream Team wrote an LNewTextEdit 
class that supports styled text and drag-and-drop editing. 
Very cool. To find out more about the PP Dream Team, 
visit their Web page at: http://petritied.cic.net/powerplant-dt/ 
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is not just an application framework. You can use 
PowerPlant to build code resources such as HyperCard 
XCMDs and control panels, or even integrate PowerPlant 
classes into existing procedural programs. 


Dave: What is your favorite part of PowerPlant? 
Dave: Tell me about the PowerPlant architecture. 
Greg: Other than the overall design, my favorite feature of 


Greg: One of my favorite toys is Lego™ blocks. You can build PowerPlant is the Drag Manager support. Drag and drop is 


complex structures by combining simple parts. PowerPlant 
follows this approach by using a mixin architecture, where 
the base classes are relatively simple, and subclasses use 


cool, and it’s one of the better implemented features in the 
Mac OS. The API is clean and simple. It took me only two 
days (and three classes) to implement all the basic support. 


multiple inheritance to combine features. 

Dave: Tell me about your life before Metrowerks. 
For example, the EditField class multiply inherits from Pane 
(so it can draw and handle mouse clicks), Commander (so it 
can handle keystrokes and menu commands), and 
Periodical (so it gets time during the event loop to flash the 
insertion point). 


Greg: I have a Bachelor’s degree from MIT in chemical 
engineering, and I spent a few years at UC Berkeley 
working on a Ph.D., also in chemical engineering, that I 
never completed. My thesis research was computer 
modeling of coal gasification reactors, and I did a lot of 

I also tried to eliminate dependencies between classes so scientific programming in FORTRAN. 


that you can use them separately. In particular, PowerPlant 
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Find Out What The Critics Are Saying... 


MacUser 


“Symantec C++ 8.0 for Power Macintosh is an excellent 

development for creating Power Mac applications. Its 

compilers are fast, and its well designed project manager 
interface is a boon for managing large projects” 


MacTech 


“All in all the product is incredibly 
good. I think that maybe Symantec has 
made life too easy for me.” 


Macworld 





| “Symantec's product is a more 
1995 Byte Magazine polished development 
Readers Choice Award environment and has the 
Best Programming Language advantage with its editor, class 
Macintosh browser and compiled code.” 
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See memory allocation in any open heap at a glance. 

we Easily spot memory leaks. 

vw» Flags heap corruption when it happens. 

vw Works with source level debugger to let you find memory problems fast. 
» Stress applications on the fly with Purge, Compact, and Zap. 

x Allocate memory at will for precise stress testing. 

> Log heap data - easily document heap status over time. 


» No need for source code: nothing inserted in code; no patches 
to the system. © 


“> Works with 24-bit, 32-bit, and modern memory managers. 
For Macintoshes with 68020 or better. Requires System 7.0 or later. 





only $99 US 


Order now from Adianta, Inc. 
Phone: (415)781-8052 ¢ FAX: (415)781-8053 


AppleLink:ADIANTA ¢ AOL:Adianta ¢ Internet:adianta @ aol.co 
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name, address, card number, expiration date, and phone number or email address. 


Also available through the MacTech Mail Order Store and APDA 
for more information contact 
*Adianta, Inc. ¢ 582 Market St #911 * San Francisco, CA 94104 








During that time, I became more interested in programming 
than in chemical engineering, so I started taking computer 
science classes. In July 1987, I bought my first personal 
computer, a Mac SE. A few months later, I dropped out of 
school to devote my time to learning Mac programming. 


One of my first projects was writing a generic application 
shell. I kept tinkering with this shell, and it eventually 
turned into version 1.0 of the THINK Class Library (TCL), 
which Symantec shipped with THINK C in July 1989. 


Dave: How did you get hooked up with Metrowerks? Did 
Greg Galanos recruit you? Was the company already 
building CodeWarrior when you started work on 
PowerPlant? 


Greg: My first contact with Metrowerks was actually with Jean 
Belanger, sometime before the MacWorld Expo in January 
1992. I lead the Programmers Group at BMUG (Berkeley 
Macintosh Users Group), and Jean called up looking for 
some volunteers to staff his booth at the show. At the time, 
Metrowerks was selling Pascal and Modula 2 compilers for 
the education market. 
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I never actually met anyone from Metrowerks then, but a year 
later John McEnerney asked me if I was interested in writing a 
new C++ framework for some little Canadian company. John 
is the PowerPC Compiler Architect for Metrowerks, and he 
worked at Symantec when I wrote TCL 1.0. 


I met with Greg Galanos and started working on 
PowerPlant in March 1993. Codewarrior as we know it did 
not exist. There was a prototype C compiler and 
environment. It fit on a floppy disk. 


Dave: A lot of people ask about cross-platform development 
using PowerPlant. I know that the Microsoft Foundation 
Classes (MFC) are the de facto standard on the Windows 
side. What's the best way to get a PowerPlant-based 
application ported to run under Windows? 


Greg: | know that a lot of people are interested in developing 
programs that run on both the Mac and Windows. 
However, PowerPlant is a Mac-only framework. 
Metrowerks has no intention of developing a Windows 
version of PowerPlant. 


To port code to Windows, I recommend that people 
investigate Mac2Win from Altura Software. The Mac2Win 
libraries emulate the Mac Toolbox on Windows. 
Metrowerks is using these libraries to port portions of the 
CodeWarrior environment to Windows. 


Dave: What are your future plans for PowerPlant? 


Greg: My future work with PowerPlant will concentrate on 
three major areas: (1) Visual programming; (2) OpenDoc; 
and (3) Copland. 


Right now, you can specify the static layout of interface 
elements using PowerPlant Constructor. Future versions of 
Constructor will let you specify runtime relationships 
between objects. For example, adding Attachments to 
Panes and linking Broadcasters to Listeners. 


If you know what you're doing, you can use PowerPlant 
today to develop both OpenDoc parts and OpenDoc 
container applications. In fact, a few programmers (besides 
me) have already done so. However, it’s not easy. Future 
versions of PowerPlant will make it as easy to create an 
OpenDoc part as it is to create a stand-alone application. 


Copland, the next major version of the Mac OS, will provide 
many new capabilities and interface elements. I intend to 
keep PowerPlant on the leading edge of Mac development 
by supporting these new features as soon as possible. 
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By Lee David Rimar 


FakeFinder 


A tiny file-launching back 
for those emergencies... 


What with it being April and the call of 
April Fool’s Day echoing in the breezes, it 
seems an appropriate time to put before 
the public this little horror that arrived at 
our desks a while back. Please bear in 
mind that when we say, “Kids, don’t try 
this at home,” this is one case where we 
mean it. It really does work, but the 
publisher, editors and staff of MacTech 
Magazine categorically refuse to stand 
behind or endorse it in any way, and 
will not be held responsible for what 
happens to you or anyone else as a result 
of your assembling this code or 
downloading the alternate Finder app. 
In fact, we can’t even be held responsible 
for what may happen to you if you read 
the article! Why not just turn the page 
now? Hey, I said turn the page! Okay, 
you asked for it... 


Wuat It Is AND 
Wuy You MIGHT WANT IT 
With current releases of the Mac OS, it’s 
sometimes hard to build a useful 
emergency boot diskette. If your hard- 
drive won't boot, you can usually use the 
Disk Tools floppy to bring up your 











system. But if you want other diagnostic and/or system recovery 
programs on your “emergency” diskette, there usually isn’t enough 
space. Enter FakeFinder. 

FakeFinder is a tiny program (under 800 bytes) that simply 
launches other programs. On emergency boot diskettes, 
FakeFinder replaces the real Finder, and frees a lot of space. 


How To Usz It 
To create an emergency boot disk with FakeFinder: 


e Format a diskette and label it Emergency. 


¢ Copy the following file(s) from your Disk Tools diskette to 
the root directory of Emergency: 
1) the System file 
2) optional: the Apple CD-ROM Extension 


e If your Mac requires any system enablers, copy these also to 
the root directory of Emergency. 


e Copy the “Finder” application from the FakeFinder package 
to the root directory of Emergency. 


You now have a bootable diskette with considerable free 
space on it. Go ahead and add any other programs you want 
in the root directory of this disk, anything that will fit. My 
personal preference is to keep most of what’s on the Disk Tools 
floppy, and add my tape backup/restore software. 

When you reboot with this diskette, FakeFinder loads and 
creates a File menu with only two items on it: Open and Quit. 

To launch any program(s), select Open. This will let you 
select any applications, aliases to applications, and even a “real” 
Finder on any mounted drive — including CDs, if you copied the 
Apple CD-ROM Extension to the diskette. 


Lee David Rimar - Lee David Rimar programs for his own amusement, but occasionally writes something useful by 
accident. If he’s not in front of a computer, he’s probably out bicycling somewhere, or playing Scrabble at his favorite coffee 
shop. He vehemently denies responsibility for this article, and calls the Launcher code snippet “embarrassingly bad”. 
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(We accept VISA and American Express. Add $10 for shipping.) 
* Call for Academic pricing 


V CodeWarrior YW C/C++ 
V Symantec ¥ Pascal 






¢ Over 170 high-powered “set and forget” routines that automate and enhance: 
event handling, windows, the tool bar, floating palettes, cursors, buttons, 
picture buttons, scroll bars, menus (pull-down, hierarchical and pop-up), 
list boxes, fields, Edit menu, clipboard, Dynamic Alerts, and more... 


Symantec (THINK) C/C++ $149 Easy to learn and easy to use 
THINK Pascal $149 : : 
Symantec C/C++ & Pascal $199 Substantial code reduction 
CodeWarrier Bronze $199 Dramatic code simplification 
CodeWarrier Gold $249 


Significantly less debugging 
e System 6 and 7 compatible 





GUI Building/Event Managing 


Tools Plus gives you the routines you need to create 
a professional looking user interface. 
Then we make it work. It’s that simple. 











Language : 

Cc/C++ 10 
(i) Pascal size: @ 12 
(@) Both 




















PowerPC ; 
¥680.0 ™ Saves Time 


Saves Money 
|] Easy to Use 





* For novice, intermediate and 
advanced programmers 
e Runs fast; needs little memory or disk space 


e Safer than toolbox routines 


¢ No royalties 





Free Evaluation Kit: 


Available on AOL, AppleLink, 
CompuServe, eWorld and other BBSs. 


Disk also available by mail. 





To shut down your Mac, select Quit, and also quit any 
other applications you may have launched. Your Mac will then 
shut down normally. 


LIMITATIONS 
(or, Tuts AIN’T No Swiss ARMY KNIFE) 
To be so small, FakeFinder leaves a lot of stuff out. The most 
important limitations: 


e No desk accesories/Apple Menu items. 
¢ Without a real Finder present, you can’t use File Sharing. 


e Programs needing to find a “Blessed Folder,” containing a 
real Finder and System, may not work. 


The point of FakeFinder was to make it as small as 
possible, so I don’t plan to solve any of these problems. 


By THE Way: How Dw Ir Ger So SMALL? 
Normally, to create an application this small, you would start in 
assembly language. But I don’t grok 68K assembler well 
enough to write anything from the ground up. So I wrote, 
compiled, linked, and tested FakeFinder using FORTRAN, a 
language I do know. Then I disassembled the compiler’s 
output, modified it to reduce the code size, and re-assembled it. 


DISCLAIMERS 
(OR, ANYTHING FREE CoMES With No GUARANTEE) 
Though FakeFinder works properly on every system I have 
tested so far, it may not work on tomorrow’s systems. This is 
because it uses the _Launch trap to sublaunch applications, 


FAKEFINDER 


and Apple says this functionality may go away in future OS 
releases. If and when that time comes, it will be necessary to 
rewrite any applications using the sublaunch facility. 


REFERENCES 
Macintosh Tech Notes #126, #180, #205 (old numbering system). 


MACHINE MC68000 


; System routines used in this module 




















_AppendMenu OPWORD SA933 
_DrawMenuBar OPWORD SA937 
ExitToSsnel | OPWORD SAQF4 
_FindWindow OPWORD SA92C 
_HFSDispatch OPWORD SA260 
_HiliteMenu OPWORD SA938 
_InitCursor OPWORD SA850 
_InitDialogs OPWORD SA97B 
_InitFonts OPWORD SA8FE 
_InitGraf OPWORD SA86E 
_InitMenus OPWORD SA930 
_InitWindows OPWORD SA912 
_InsertMenu OPWORD S$A935 
_Launch OPWORD SA9F2 
_MenuSelect OPWORD SA93D 
_NewMenu OPWORD SA931]1 
_StdFile OPWORD SA9EA 
_SsetVol OPWORD SA0Q15 
_WaitNextEvent OPWORD SA860 





START: MAIN 
; make a stack, initialize managers, and set up menus 
link a6,#-664 


lea (266,a7) ,a2 ; qd.grafport 
move. 1 a2, (a7) 

_InitGraf 

_InitFonts 

_InitWindows 

_InitMenus 

_InitDialogs 
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World's Leading FORTRAN 77 for Macintosh 


68K and Power Macintosh versions 


° full ANSI 77 native compiler 

° faster execution speed 

- graphical source-level debugging 
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_InitCursor - If (FindWindow( 
; VAL(event.where),dummy) != inMenuBar) Loop 
lea AppleMenu, a2 
move. 1 a2, (a7) lea (272,47) 42 
move.w #580, (4,a7) move. 1 a2, (a7) 
_NewMenu move.1 (298,a7),(4,a7) 
move.l (a7) ,a3 _FindWindow 
move.w #0, (a7) move.w (a7) ,d3 
move. 1 a, (2587) sub. 1 #8 ,a7 
_InsertMenu cmp .w #1,d3 
lea FileMenu, a2 bne.s Loop 
move. l a2, (a7) 
move.w #581, (4,a7) ; pick = MenuSelect(VAL(event.where)) 
_NewMenu : Call HiliteMenu(VAL2(0)) 
move.l (a7)=23 
move.w #0, (a7) move.l (298,a7), (a7) 
move.l a3,(2,a7) _MenuSelect 
_InsertMenu move. 1 (a7) ,d3 
lea Menultems,a2 move.w #0, (a7) 
move.1l a2,(a7) _HiliteMenu 
move.1 3, (4,a7) sub. 1 #6 ,a7 
_AppendMenu 
_DrawMenuBar ; If (pick == z'00810001') GetFile 
; If (pick != z'00810002') Loop 
sub.1 #36,a7 : Call ExitToShell 
Loop: cmp. 1 #$810001,d3 
beq.s GetFile 
- If (NOT. WaitNextEvent( cmp. 1 #5810002,d3 
: VAL2(-1),event, VAL(15), VAL(O))) Loop bne.s Loop 
move.l #0, (a7 _ExitToShell 
move. 1 #15, (4,a7) 
lea (288,a7),a2 GetFile: 
move.l a2; (8,al) 
move.w #-1,(12,a7) - Call SFGetFile( 
_WaitNextEvent VAL(coords),0, VAL(O), VAL2(3),types, VAL(O), reply) 
move.b (a7) ,d3 
sub.1 #5000e,a7 lea (304,a7) ,a2 
recs o d3 move.1 a2, (a7) 
beq.s Loop move. 1 #0, (4,a7) 
lea types,a2 
; If (event.what != mouseDown) Loop move. 1 a2, (8, al) 
move.w #3, (12,a7) 
move .w (288,a7) ,d3 move. 1 #0, (14,a7) 
cmp.w #1,d3 move.1 #0, (18,a7) 
bne.s Loop move. 1 #so0s000%0, (22,a7) 
move.w #52, - ( 
_StdFile 
sub. 1 #S500la,a7 
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Features Screen Blitting 44/ a5 /PPC 
Complete User-Definability 


px] Custom Default Buttons 
a Custom Item Callbacks 
[x] Cursor-Sensitive Help 


Automatic Radio Button Groups ¥ 


Multi Panel Preferences h 


(*) Tabs - Switch panels with tab sheet 


C List - Switch panels with custom icons 
x] Mouse-Sensitive Cursor 
Ex] Custom ‘window Font 


() Radio Buttons - Switch panels with buttons fx] Password Edit Fields 


(2 Popup - Switch panels with a popup 


This context-sensitive help field was filled The scroll bars on this text edit field 
when the mouse passed over the Multi Panel become active when the data reaches 
menu. the bottom of the bounding rectangle. 


Meet Charlie. Charlie likes to program. But Charlie hates boring, repetitive code, so 
he created OpenDialog™ OpenDialog is “everything the Dialog Manager should've 
been.” Use Charlie’s head for dialogs and save your head (and your hair) for real 
problems. A set of libraries that replace the Dialog Manager, OpenDialog will 


e Simplify creation of multi-panel e Easily integrate into existing code. 
items, such as preference dialogs. © Cost only $259 (source code license 
© Relieve you of silly chores, like available). 
managing radio buttons. e Keep you from going bald. (Charlie 
© Provide you with “no-resource” lost his hair before OpenDialog.) 
dialogs for alerts & progress bars. 


FGM Inc. © 703.478.9881 © http://www.fgm.com © email: opndlg42@fgm.com 





; If NOT. reply.good) Loop 


move.b (304,a7) ,d3 
tst.b d3 
beq.s final 


; myPB.p_ioName = LOC(reply.fName) 

; myPB.ioVRefNum = reply.vRefNum 

; myPB.ioFDirIndex = 0 

; myPB.ioDirID = 0 

; If PBGetCatInfoSync(myPB) != 0) Loop 











lea (314,87) ,a2 
move. 1 a2, (478,a7) 
move.w (310,a7), (482,a7) 
move. 1 #0, (488,a7) 
move.1 #0, (508,a7) 
lea (460,a7) ,a2 
move. l ad, (a7?) 
movea.1 (a7 )*:a0 
move.w #9 ,d0 
_HFSDispatch 

sub.1 #4, a7 

tst.w d0 

bne.s final 


; params.ioCompletion = 0 

; params.ioResult = 0 

; params.p_ioName = 0 

; params.ioVRefNum = reply.vRefNum 
; If(PBSetVolSync(params).LT.0) Loop 


move.1 #0, (392,a7) 
move.wW #0, (396,a7) 
move.1l #0, (398,a7) 
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move.w (310,a7),(402,a7) 


lea (380,a7),a2 
move.1 a2, (a7) 
movea.1 (a7)+,a0 
_SetVol 
sub. 1 #4,a7 

; ap.pfName = LOC(reply.fName) 

; ap.param = 0 

; ap.LC = z'4C43' 


; ap.extBlockLen = 6 
; ap.fFlags = myPB.ioFlFndrInfo.fdFlags 
; ap.launchFlags = z'C0000000' 


lea (314,a7),a2 

move.l a2, (568,a7) 

move.w #0, (572,a7) 

move.w #54043, (574,a7) 

move.l #6, (576,a7) 

move.w (500,a7), (580,a7) 
mi 








#5c0000000, (582,a7) 


; ignore = launch(ap) 


lea (568,a7),a2 

move.1 a2, (a7) 

movea.l (a7)+,a0 

_Launch 

sub.1 #4,a7 
final: bra Loop 


; some constants embedded in code section 


types: ; file types for getfile, what you can launch with FakeFinder 


GC .c. $4150504c ; APPL 
died $464e4452 ;FNDR 
dce.l $61647270 ; adrp (application aliases) 


AppleMenu: ; Apple Menu character, for appearances only! 


de.b 1 
de.b 20 


FileMenu: ; Pascal String “File” 


de.b 4 

de.b 70 

de.b 105 

dc.b 108 

de.b 101 

deb 0 ; pad so next lands on even address 


Menultems: ; Pascal string “Open;Quit” 


de.b 9 
de.b 79 
de.b 112 
dce.b 101 
de.b 110 
dce.b 59 
dce.b 81 
dce.b it] 
de.b 105 
de.b 116 
ENDMAIN 

END 
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By Grant Neufeld, InfoDesign Corporation 


Or: How I Learned 
to Stop Worrying 
and Love to Bomb 


As Jon Wiederspan points out elsewhere 
in this issue, threading is becoming a 
serious problem for webmasters intent on 
getting speed out of their servers. In C 
the problem is compounded because the 
AppleEvent Manager does not handle 
multiple simultaneous events (and Apple 
events are used to communicate with 
CGI applications). Grant Neufeld has 
developed a solution to this problem and 
distributes a CGI framework that 
implements it for you. In this article, he 
shows us how it’s done. 

On the Thread Manager, see also: 
http://www.mactech.com/Articles/Vol.10/ 
10.11/Thread-Manager.bhtml#Thread- 
Manager 
http://www.mactech.com/Articles/Vol. 10/ 
10.11/Threading.bhtml#Threading 

For Frontier as a possible solution to 
threading difficulties, see MacTech 
Magazine 12.1 (January 1966) 63-65; 
see also the technologies discussed by Jon 
in our MacWorld Expo report. On 
writing your CGI in C, see MacTech 
Magazine 11.9 (September 1995) 33-42. 








Threading Apple Events 





"THE PROBLEM OF REENTRANCY 


As I recently discovered, trying to combine Apple events with the 
Thread Manager is an awkward and mind-altering experience. 
There are some fundamental — and obscure — requirements that 
are easy to miss (or so Id like everyone to believe, so that I don’t 
have to be so embarrassed by my own oversight). 

The fundamental problem is that AEProcessAppleEvent 
is non-reentrant. So, if you call it, you can’t call it again until 
the event finishes processing. I didn’t know this when I 
originally designed the threading for my CGI framework, so I 
happily set about an implementation whereby I could call 
AEProcessAppleEvent multiple times before finishing the 
first call — all through the glory of the Thread Manager. My 
incorrect code looked like: 


/* warning: bad code! Don’t try this at home! */ 
/* Called from main event loop when a high level event arrived. */ 
void doHighLevelEvent ( EventRecord *theEvent ) 
{ 

OSErr theErr; 

ThreadID theThread; 


if ( gHasThreadMgr ) { 
// MyNewThreadFromPool is just a custom method to simplify 
// using threads from a pool. 
// Remember: this particular example of Apple event threading 
// is wrong - don’t do it this way! 
theErr = MyNewThreadFromPool ( doAEThread, theEvent, 
(void**)nil, &theThread ); 
} 
if ( !gHasThreadMgr || (theErr != noErr) ) { 
// If threading isn’t available, or the attempt to thread failed, 
// process the Apple event without threading. 
theErr = AEProcessAppleEvent ( theEvent ); 


| 
J 


| 
J 


/* The thread entry function that was used to process the Apple event. */ 
pascal void * doAEThread ( void *theEvent ) 
{ 

OSErr theErr; 

ThreadID currentThread; 





Grant Neufeld — Aside from developing workflow software for Macintosh systems at InfoDesign Corporation, Grant runs an 
internet server on a Quadra 660AV, does graphic design, writes internet related software, gloats over his growing LEGO 
collection and attends radical protests carrying his trusty megaphone called “The Voice of Grant.” You can reach him at 


grant@acm.org or http://arpp.carleton.ca/grant/. 


Jon Wiederspan was contributing editor for this article. 
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isposeThread ( currentThread, (void *)theErr, true ); 


The amazing thing is that nobody — including me — caught 
the error until Wayne K. Walrath took a look at the code (in the 
eleventh release) and noticed my mistake. By then, programs 
were already shipping and in commercial use — including my 
own Random URL CGI. 

So, why didn’t anyone notice the code crashing? The code 
we all had in our threads happened to be fast enough to finish 
before new Apple events came in. This doesn’t mean it would 


> jevanld Doe 
> aa T.Distionary 


a te treeton EY Sy ota never crash; given a situation where two Apple events came in 
: » Gee almost simultaneously, the code would certainly flop. 

 savautt Preertee ae > z ouere tema Thankfully, I had the prescience to include a suitable 

Dp jevatnah \ | disclaimer and label the code “beta” and “subject to errors” to 

b Here aeleo. cover my legal posterior. However, my public esteem was in 

SSR TRB jeopardy! Worse still, I couldn’t touch the code for a few days 

ibgieieanudt noe after receiving the bug report because of job obligations. 


Actually, that was a good thing because the time spent thinking 
about the code gave me a good basis to start from when I did 
actually get down to work. 

Moral: Think before you code. (Carefully reading the 
documentation isn’t a bad idea either!) 


SUSPENDING APPLE EVENTS 

My original code attempted to thread every Apple event. This 
is not the case with the corrected code. A new thread should 
only be initiated within the context of an 
AEProcessAppleEvent call if the Apple event has been 
successfully suspended. Suspension of Apple events involves 
calls to the functions AESuspendTheCurrentEvent and 
AEResumeTheCurrentEvent. 

If the Apple event does not suspend, you can’t make any 
further calls to AEProcessAppleEvent, so you must not create a 
sub-thread unless you implement a mechanism to prevent calls to 
AEProcessAppleEvent until the current Apple event finishes. 
If you want to be creative, you can write your own Apple event 
cclerated for dispatcher to allow reentrancy, thereby making it easier to deal 

with threads. People might call you crazy, but you can do it. 

Which brings us to the obligatory complaint about lack of 
sufficient (and clear) documentation (which is part of the reason 
I’m writing this). Inside Macintosh: Interapplication 
Communication doesn’t sufficiently cover the use of the necessary 
calls and provides no sample code for suspending Apple events 
(see IM-IAC 4.85-88). Hopefully, this article helps fill that gap. 

The CGI Apple event is the only one I’m concerned about 
threading for my framework, so I didn’t bother with any of the 
other events. I handle the Apple event arrival in the normal way 
with a handler installed to be called by AEProcessAppleEvent: 
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/* Apple event Handler for the CGI WWWQsdoc event */ 
pascal OSErr 
CGIAESearchDoc ( AppleEvent *theAppleEvent, 
AppleEvent *theReply, long Reference ) 
{ 
OSErr theErr; 
CGIHd1 theCGIHd1; 
ThreadID theThread; 


// Allocate the CGIHdI data structure - zeroing out its contents. 
theCGIHdl = (CGIHd1) 
MyNewHandleClear ( sizeof(CGlIrecord), &theErr ); 
if ( theCGIHdl == nil ) { 
return theErr; 


// Store references to the apple event and reply records. 
(*theCGIHd1) ->appleEvent = *theAppleEvent; 
(*theCGIHd1) ->replyEvent = *theReply; 


if ( gHasThreadMgr ) { 
// It is necessary to suspend the Apple event in order to thread its processing 
// because of some real weirdness with AEProcessAppleEvent not being 
// “reentrant.” This means you can’t be processing multiple Apple events at 
// the same time, so they have to be ‘suspended’ if you want to deal with more 
// than one (1.E., multi-threaded processing). 
theErr = AESuspendTheCurrentEvent ( theAppleEvent ); 
if ( theErr == noErr) { 
(*theCGIHd1) ->suspended = true; 
// Apple event has been suspended, so we can spawn a thread for processing. 
theErr = MyNewThreadFromPool ( 
CGIAESearchDocProcessThread, theCGIHdl, 
(void**)nil, &theThread ); 
} 
} 


if ( !gHasThreadMgr || (theErr != noErr) ) { 
// If threading isn’t available, or the attempt to thread failed, or the attempt to 
// suspend the Apple event failed, process the Apple event without threading. 
theErr = cgiAESearchDocProcess ( theCGIHdl ); 
} else { 
// We suspended the Apple event, and spawned the thread, now let’s start it. 
YieldToThread ( theThread ); 
} 


return theErr; 


The support for threading begins in the CGIAESearchDoc 
function. First, I confirm the presence of the Thread Manager. 
If it is available, I attempt to suspend the Apple event so that it 
will be safe to process subsequent Apple events before finishing 
the current one. If the suspension is successful, I call my thread 
function for the event, which in turn calls the function that does 
the actual work of handling the event request. 


/* Entry point for CGI handler thread. threadParam must not be nil. */ 
pascal void * 
CGIAESearchDocProcessThread ( void *threadParam ) 
{ 

OSErr theErr; 

CGIHd1 theCGIHd1; 

ThreadID currentThread; 


// The threadParam is used to pass the CGIHdL. 
theCGIHd1 = (CGIHd1)threadParan; 


theErr = cgiAESearchDocProcess ( theCGIHdl ); 


// Find the ID of current thread and use DisposeThread to dispose of it so that 
// my custom thread termination procedure will be used to recover this thread’s 
// allocation for the thread pool. 

GetCurrentThread ( &currentThread ); 

DisposeThread ( currentThread, (void *)theErr, true ); 


// This line below is actually irrelevant, since the DisposeThread call above 

// will result in the immediate termination of this thread. 

// \keep it in because a return result is needed for the compiler not to issue a 
// warning (and I have the “treat all warnings as errors” flag set in my 
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// compiler, like every programmer should). 
return (void *)theErr; 


The basic flow of my CGI Apple event handling (if we 
ignore the threading) starts with CGIAESearchDoc which 
leads to cgiAESearchDocProcess (which calls 
CGIAEResumeComplete if the Apple event is suspended), 
finishing with cgiAEComplete. This structure allows the 
necessary threading and Apple event “wrapper” functions to be 
put around the cgiAESearchDocProcess. If the Apple 
event is successfully suspended, an attempt is made to create 
the thread, which then carries the remainder of the processing. 
If either the suspend or thread fails, processing will still occur — 
just without threading. 


Resuming the Apple event 

cgiAESearchDocProcess checks the suspension of the 
Apple event to determine how it should call the completion 
function. If the Apple event was suspended, it must be 
resumed using AEResumeTheCurrentEvent before 
cgiAEComplete can be called. 


/* Process the CGI WWWQsdoc Apple event. 

theCGIHdl must be valid (non-nil) and unlocked. */ 
static OSErr 
cgiAESearchDocProcess ( CGIHdl theCGIHdl ) 
{ 

OSErr theErr; 

AppleEvent theAppleEvent; 


// Copy the AppleEvent record pointer into a local variable for faster access. 
theAppleEvent = (*theCGIHd1) ->appleEvent; 


// The following section (not shown in this listing) is where the parameters are 
// pulled from the CGI Apple event and allocated in the CGI Handle. 
// That is followed by a call to the application specific CGI handler function. 


if ( (*theCGIHd1l)->suspended ) { 
// We're in a suspended Apple event, so we'll need to resume the 
// Apple event to have it complete and return the reply properly. 
theErr = AEResumeTheCurrentEvent ( 
&theAppleEvent, &((*theCGIHd1) ->replyEvent) , 
vCGIAEResumeCompleteUPP, (long)theCGIHd1 ); 
} else { 
// We weren't suspended, but still need to take care of the Apple event 
// reply record. 
theErr = cgiAEComplete ( theCGIHdl ); 
} 


return theErr: 


} 


/* Call the event completion function (cgiAEComplete) when resuming 
suspended Apple events. theReference must be a CGIHdl. */ 

pascal OSErr 

CGIAEResumeComplete ( const AppleEvent *theAppleEvent, 
AppleEvent *theReply, long theReference ) 

{ 
OSErr theErr; 


theErr = cgiAEComplete ( (CGIHd1)theReference ); 


return theErr; 


} 
/* Complete the CGI Apple event. theCGIHdl must be valid. */ 
static OSErr 
cgiAEComplete ( CGIHd1 theCGIHdl ) 
{ 
OSErr theErr; 


HLock ( (Handle)theCGIHdl ); 
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if ( (*theCGIHd1l)->responseData != nil ) { 
// If the user’s “MyCG]Process” function set the responseData properly, return it. 
theErr = AEPutParamPtr ( &((*theCGIHd1) ->replyEvent) , 
keyDirectObject, typeChar, 
(Ptr) ((*theCGIHd1) ->responseData) , 
(*theCGIHd1) ->responseSize ); 
} else { 
// If the user’s “MyCGIProcess” failed to set the responseData properly, 
// return an error header. 
theErr = AEPutParamPtr ( &((*theCGIHd1) ->replyEvent) , 
keyDirectObject, typeChar, (Ptr) gHTTPHeaderErr, 
gHTTPHeaderErrSize ); 
} 


HUnlock ( (Handle)theCGIHd1 ); 
cgiDisposeHandle ( theCGIHdl ); 


return theErr: 


USING PREALLOCATED THREADS 

One thing to be concerned about is overloading on threads. 
Having a handful of threads available can improve performance, 
but running dozens of threads can bog things down - especially 
in terms of memory usage, since each thread has its own stack 
allocated in the application heap. Because of this, creating 
threads can quickly eat up a significant chunk of memory. You 
can reduce this somewhat by calculating the maximum total 
space you will need for the thread stack and using that value in 
place of the default when allocating threads. However, memory 
use by threads will still be a significant matter. 
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A good strategy is to preallocate a limited number of 
threads and use only those. This has the double advantage of 
increasing the thread allocation speed and reducing heap 
fragmentation. In your application initialization sequence, 
you'll need to allocate a pool of threads after confirming that 
the Thread Manager is available. 

// Pre-allocate the required number of threads. 


// kStartupThreadsPreallocate is a constant defined in “MyConfiguration.h” 
// which I use to define the total number of threads to preallocate 


kStartupThreadsPreallocate, nil ); 


You will want to use a wrapper call to NewThread to put 
the current thread to sleep if there aren’t any available threads 
in the pool. This is done so that one of the active threads may 
have time to complete, at which point the finishing thread will 
“wake up” the sleeping thread, allowing it to continue on from 
the point where it went to sleep, with a thread (the one that 
just finished) now available from the preallocated pool. 

/" Allocate a new thread from the existing pool of threads. 
If there are no threads available, yield to other threads until one finishes. 
The Thread Manager must be available for this function to work. */ 
te eoudiesnbost ( ThreadEntryProcPtr threadEntry, 


void * threadParam, void ** threadk 
ThreadID * threadMade ) 
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OSErr theErr; 
short threadsFree;: 
ThreadID currentThread; 
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theErr = GetFreeThreadCount ( kCooperativeThread, 
&threadsFree ); 

if ( theErr == noErr ) { 
theErr = GetCurrentThread ( &currentThread ); 

} 

if ( (theErr == noErr) && (threadsFree == nil) ) { 

// Put the current thread to sleep, to be woken up when a thread becomes available. 
gThreadSleeper = currentThread; 
theErr = SetThreadState ( currentThread, 
kStoppedThreadState, nil ); 


if ( theErr == noErr ) { 
// Install the new thread using a premade thread from the pool. 
theErr = NewThread ( kCooperativeThread, 
threadEntry, threadParam, nil, 
kFPUNotNeeded + kUsePremadeThread, 
threadResult, threadMade ); 
} 
if ( theErr == noErr ) { 
// Set the termination function for the thread. 
SetThreadTerminator ( *threadMade, 
myThreadTermination, nil ); 


// Increment the total number of sub-threads. 
++gThreadTotal; 


// Decrease the sleep ticks so we'll take more processing time. 


gSleepTicks = kSleepTicksWhenBusy; 
return theErr; 


A thread termination callback procedure is used to wake 
up the sleeping thread when another thread is finished. 
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/* The Thread Manager must be available for this function to work. */ 
pascal void 
myThreadTermination ( ThreadID threadTerminated, void 
*terminationProcParam ) 
{ 
if ( gThreadSleeper != nil ) { 
// Wake up the sleeping thread so that it may be called when other threads yield. 
theErr = SetThreadState ( gThreadSleeper, 
kReadyThreadState, nil ); 
eThreadSleeper = nil; 
} 


// Lower the count of sub-threads. 
--gThreadTotal; 


if ( gThreadTotal == nil ) { 
// If there are no more threads, reset the sleep ticks to normal. 
gSleepTicks = kSleepTicks; 
} 
} 


WHEN TO THREAD 

After considering all this, you should ask yourself whether you 
really need to thread your Apple event handlers. The keys to 
answering this question are whether there are any points in the 
handler where it would be appropriate to yield the processing 
to other threads, and, more importantly, whether the handler is 
big and slow enough to see performance benefits from 
threading. Keep in mind that there is overhead and complexity 
added when you use cooperative threading. 

As an example, I didn’t thread my Random URL CGI 
because its response time (with rare exception) is under a 
second. To thread it would only add time to the total process 
without any real improvement in performance (not to mention 
increased memory requirements). On the other hand, a form- 
handling CGI I’m working on is threaded, because it will 
frequently have to talk (through Apple events) to other 
applications, which can slow things down appreciably (and 
waiting for a response is a great time to yield processing). 


FURTHER CONSIDERATIONS 

If your application spawns threads from any threads apart from 
the main thread, you will need to maintain a queue of sleeping 
threads rather than just the one stored in this article’s code. 
Another important consideration, that hasn’t been covered here, 
is to make sure that WaitNextEvent is still periodically called 
if the main thread is put to sleep. You don’t absolutely have to 
do that, but it is strongly recommended so that other 
applications and processes can have time to run. You may want 
to think about resetting the calling application’s Apple event 
timeout timer when an event is taking a long time to process. 
Additionally, any CGI that wants to support the new “Send 
Partial” multi-stage reply mechanism in WebSTAR will need to 
make more advanced use of threading and Apple events. 


Grant's CGI framework comes with project files for the 
CodeWarrior, THINK C and Symantec Project Manager 
environments. 

Discussion mailing list: grantcgi@arpp1.carleton.ca with the 
subject set to: help 

Home page: http://arpp.carleton.ca/grant/mac/grantscgi/ 
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INTRODUCTION 


This article documents the creation of an 
ad hoc application using MacApp. Our 
goal was simple: build a documentation 
viewer for our manual, presentation 
slides, scripting dictionary, and product 
screen-shots. A quick survey of the 
existing viewer tools had led us to the 
conclusion: “What? They want how 
much money? Hey, we don’t need all 
those features!” (Of course, this all 
happened back before Adobe dropped 
its per-reader fee for Acrobat from $25 to 
zero.) So we decided to do it ourselves. 

The requirements for this 
application are straightforward. The 
screen must display an exact duplicate 
of the original printed pages. Access to 
the pre-formatted documentation source 
is denied, but the user can copy and 
print the displayed pages. Simple page 
navigation is needed, but not content- 
based searching. The last requirement 
is the name: we're working at 
WorldView, so it is natural to title the 
application WorldViewer. 


APPROACH 
The first hurdle is to create the on-line 
documents from a variety of publishing 
applications. If a bitmapped picture 
approach is used, the documentation 
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files will be huge, printed pages cannot rescale text for maximal 
printer resolution, and zooming will show “jaggies”. On the 
other hand, if a picture ('PICT') file or resource is used, then 
the image will scale correctly. An added benefit is that the Mac 
toolbox routine DrawPicture substitutes fonts if the original 
fonts are not present. Our solution is to use the shareware 
utility Print2Pict, by Baudouin Raoult. It is placed into the 
Extensions Folder and activated by using the Chooser to select 
it as the “printer”. When you “print”, Print2Pict records each 
output page as a 'PICT' resource in a scrapbook file. 

The WorldViewer application itself is based on MacApp 3.3 
(actually, it was originally done with MacApp 3.1, and source 
code for both versions is provided). As many Macintosh 
programmers already know, MacApp is an object-oriented 
framework for writing applications. The main advantage is that 
the developer can leverage tens of programmer-years of work 
and have instant support for AppleEvents, the Scrap Manager, 
window management, event handling, printing, and other 
modules required of almost all Macintosh programs. Our 
application was written in only a few days and contains less 
than a thousand lines of source code. 


Presenting 





Figure 1. A sample document in WorldViewer 
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HUMAN INTERFACE 


Figure 1 illustrates the final screen interface. It evolved during 
development (as so often happens), but let’s pretend the design 
was fully completed first. 

Separate tools are needed for navigating forward and 
backward, scrolling the page within the window, and zooming. 
The navigation operation should be context-dependent: the 
next-page cursor icon is displayed when the cursor is on the 
right-hand side of the screen and clicking goes to the next 
page; whereas, clicking the left side of the view goes to the 
previous page. Important information is to be displayed: the 
document name (in the window title), the page number (in 
lower-left), and the selected tool Chilited at bottom, also in the 
cursor icon). Modifier keys must switch between tool types, for 
power users; for example, holding the shift-key down changes 
from zoom-in to zoom-out, and depressing the option-key 
activates the hand (scrolling) tool. Dialogs are needed for 
selecting specific pages to jump to, and exact zoom amounts. 
A mechanism to navigate by sections or chapters instead of 
pages would be helpful for large documents. 


Figure 2 shows the menu interface, without command-key 


equivalents. The menu titled Section should change to reflect 
the make-up of the document file in the frontmost window. 
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Figure 2. Menu structure for WorldViewer 


IMPLEMENTATION 

The object-oriented design of MacApp is ideal for our project. 
The document class can be used to identify each open 
documentation file. A view class can be used to draw a page of 
the documentation file. The control classes can be used as bases 
for writing both the page number control and the tools palette. 

In all, eight classes were needed to implement 
WorldViewer. The following is a listing of the class declarations 
from the interface source file. MacApp-required source lines 
such as MA_DECLARE_CLASS; have been removed to reduce 
clutter (see the complete source code online). 


TWVApplication class 


class TWVApplication : public TApplication { 
public: 
void IWVApplication(void) ; 
virtual TFile* DoMakeFile(CommandNumber aCommandNumber) ; 
virtual TDocument* DoMakeDocument ( 
CommandNumber itsCommandNumber, TFile* itsFile); 
virtual void DoMenuCommand(CommandNumber aCommandNumber) ; 
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The TWVApplication is descended from 
TApplication, the base application class of MacApp. The 
DoMakeFile method overrides the default method so that the 
document file’s resource fork remains open. If each 
documentation file stays on disk and 'PICT' files are loaded 
only when needed, the application memory partition is 
minimal. The only purpose of the DoMenuCommand method is 
to intercept calls to the About... menu command. 


TWVDocument 


class TWVDocument 
public: 
void IWVDocument(TFile* itsFile, OSType itsCreator) ; 
void SetupFile(void) ; 
virtual void Close(void) ; 
virtual void DoMakeViews(Boolean forPrinting) ; 
virtual void DoSetupMenus (void) ; 
virtual void DoMenuCommand(CommandNumber aCommandNumber) ; 
virtual long GetChangeCount (void) ; 


: public TFileBasedDocument { 


The TWVDocument class is responsible for interacting with 
the documentation file. The SetupFile method is used to set 
the documentation file as frontmost in the resource chain. 
Without this method, the viewer may load in incorrect 'PICT' 
resources from documentation files with identical resource 
numbers. The DoMakeViews method specifies which 'View' 
resource to use to display the document. A 'View' resource 
specifies the placement of dialog items, like a 'DITL' resource 
souped up to handle more versatile display objects. 

The purpose of overriding the DoSetupMenus and 
DoMenuCommand methods is to have the ability to create 
multiple windows to view the same document. It’s easy using 
MacApp — only a few lines of code are needed! 


TPageView 


class TPageView : public TView { 
public: 
short fMaxPages, // max. number of pages 
fPage, // page number 
fZoom; // zoom amount 
void SetupFile(void) ; 
virtual void DoPostCreate(TDocument* itsDocument) ; 
void SetPage(short newPage) ; 
void SetZoom(short newZoom, VPoint center) ; 
void SetTool(short newTool); 
virtual void DoSetupMenus (void) ; 
virtual void DoMenuCommand(CommandNumber aCommandNumber) ; 
virtual void DoEvent(EventNumber eventNumber, 
TEventHandler* source, TEvent* event); 
virtual void DoKeyEvent (TToolboxEvent* event) ; 
virtual void Draw(const VRect& area); 











The documentation page, scrollbars, and controls are 
displayed within the TPageView class. The method 
SetupFile operates identically to the same-named method of 
TWVDocument. In DoPostCreate, the default view and 
window sizes are set to the size of the first 'PICT' stored in the 
document file. The DoSetupMenus and DoMenuCommand 
methods are for implementing the zooming and navigation menu 
commands. The Draw method first makes a call to SetupFile 
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before drawing the containing view objects. This assures that 
the correct 'PICT' resource is drawn by the picture object. 


TPagePicture 
class TPagePicture : public TPicture { 
public: 
short fTool; // [arrow,hand,zoom] 
CCrsrHandle fCursor; // color cursor 
TPagePicture(); // constructor 
virtual void Activate(Boolean entering) ; 
virtual void DoSetCursor(const VPoint& localPoint, 
RgnHandle cursorRegion) ; 
virtual void DoMouseCommand(VPoint& theMouse, 
TToolboxEvent* event, CPoint hysteresis); 





The TPagePicture class displays the 'PICT' resource 
from the documentation file. The field Tool stores the tools 
status, either navigation arrow, hand, or zoom. The fCursor 
field caches the color cursor, reducing the number of times a 
color cursor must be created from a resource. 

The Activate method instructs the application to always 
track the cursor; this provides instantaneous change in the cursor 
icon when a modifier key is pressed. The method DoSetCursor 
sets the cursor to reflect the appropriate tool, based on the fTool 
field, keyboard modifiers, and page number; see Figure 3 for the 
cursor icon set. In DoMouseCommand, the appropriate command 
is dispatched given the tool and keyboard modifier states. 








< Seo 


Figure 3. Color cursors 


TScrollCmd 


class TScrollCmd : public TTracker { 
public: 

CCrsrHandle fCursor; // closed hand cursor 

VRect fOrigRect; // original visible rectangle 

VPoint fOrigPoint; // original anchor point (window coords) 

void IScrollCmd(TPagePicture* aPagePicture, 
const VPoint& aMouse): 

virtual void TrackFeedback(TrackPhase trackPhase, 
const VPoint& anchorPoint, 
const VPoint& previousPoint, 
const VPoint& nextPoint, 
Boolean mouseDidMove, 
Boolean turnItOn) ; 

virtual TTracker* TrackMouse(TrackPhase trackPhase, 
VPoint& anchorPoint, VPoint& previousPoint, 
VPoint& nextPoint, Boolean mouseDidMove) ; 


The TScrol1Cmd is used for scrolling the documentation 
page within the view. The open-hand cursor is replaced by a 
closed-hand cursor, and the scrolling parameters of the view 
are changed as the cursor moves. The scrolling operation is 
straightforward using MacApp: the display rectangle of the 
TPageView object is modified based on the cursor location, 
the screen image is scrolled, and the revealed areas of the 
picture are drawn. 
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TPageText and TPagelcon 


class TPageIcon : public TIcon { 
public: 
virtual void Hilite(void) ; 
virtual void SuperViewChangedFrame(const VRect& oldFrame, 
const VRect& newFrame, Boolean invalidate) ; 
b3 
class TPageText 
public: 
virtual void Hilite(void) ; 
virtual void SuperViewChangedFrame(const VRect& oldFrame, 
const VRect& newFrame, Boolean invalidate); 


: public TStaticText { 


The display of the page number in the lower-left corner of 
the window is handled by the TPageText class. The 
TPagelcon class displays the selected tool at the bottom of 
the window. The Hilite methods change the control hiliting 
method from a simple inversion (the default MacApp method) 
to coloring the empty area with the system selection color. The 
SuperViewChangedFrame methods are required so that the 
control relocates itself in the bottom-left corner when the 
window is resized. 


TPagePrintHandler 


class TPagePrintHandler : public TStdPrintHandler { 
public: 

void IPagePrintHandler(TView* aView); 
virtual Boolean Print (CommandNumber itsCommandNumber) ; 
virtual Boolean SetupPrintOne(void) ; 
virtual void SetPage(long aPageNumber) ; 
virtual void CalcPageStrips(VPoint& pageStrips); 
virtual void DrawPageInterior(void) ; 





The printing of a document page requires some special 
handling. The default MacApp mechanism divides a view into 
printer page-sized output pieces and prints the pages 
sequentially. The methods of TPagePrintHandler 
collectively make sure that the selected page is the correct 
'PICT' resource from the document file. 


Dialogs 
Two dialogs are needed to input specific values for going 


to a page number or setting the zoom amount. Figure 4 
shows them. 


Enter page number 
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Enter 700m amount 





Figure 4: Go to and Zoom dialog boxes 


The MacApp utility application ViewEdit was used to 
create all dialogs. Note that no application-specific classes are 
needed to instantiate, activate, and get the results from these 
dialogs. This illustrates the fact that new subclasses are not 
needed for every different operation. Here is a code snippet 
from the method TPageView: :DoMenuCommand processing 
the GoTo... menu command (some error-checking and 
declaration code have been removed). 





TPageView::DoMenuCommand [excerpt] 
// create new window containing dialog 
aWindow = gViewServer->NewTemplateWindow(kGoToView, NULL) ; 
// set current page in text edit object 
aEditText = (TEditText*) aWindow->FindSubView('tPgi") 
NumToString(fPage + 1, string); 
aEditText->SetText(string, kDontRedraw) ; 
// pose the dialog window 
if (aWindow->PoseModally() == 'bOK ') { 
// get new page number 
aEditText->GetText (string) ; 
if (!string.IsEmpty()) { 
StringToNum(string, &page); 
this->SetPage (page) ; 
1% 
5 
aWindow->CloseAndFree() ; 


Sections 

One feature not yet covered is the ability to move forward 
and backwards through the documentation pages by sections 
or chapters. This is accomplished by adding the resource 
'indx' to the documentation file that lists the section names 
and the starting page number of each section. When a 
documentation file is opened and activated within 
WorldViewer, the menu items under the Section menubar are 
changed to the section names. When one of these menu items 
is selected, the page associated with the section start is 
automatically displayed. Here we show the MPW Rez source 
file used to create the section resource. 





dictionary.r 
// Creates an ‘indx’ resource for a WorldViewer documentation file 


finclude "Types.r" 
type ‘indx' { 
integer = $$Countof(IndexArray) ; 


array IndexArray { integer; pstring; align word; }; 


ie 
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Control multiple 
MAC’s with one keyboard, 
monitor and mouse 


¢ Control up to 32 MAC’s with 
one switch. 


¢ Prices starting at $90. 
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¢ Multiple devices on ADB Bus. 

¢ Display the same high quality pea 
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monitors. 

4150 MHz bandwith. 


Keyboard and monitor cables up to 
250 ft. long. 
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resource ‘indx' (1000, "index", purgeable) [{ 
{ 

, “Title”, 

, "Required Suite", 

»"Core Suite", 

, "Miscellaneous Standards", 

, "Reality Suite", 
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CREATING A DOCUMENT 

Here is an example of creating a WorldViewer documentation 
file. First, install the Print2Pict utility and select it using the 
Chooser. Open the Print2Pict options and choose to print to a 
new scrapbook file. If you like, you can reduce the default 
page size to a screen-sized amount, such as 4 by 0. 

Next, start your favorite word processing program and 
enter the following lines, separated by a page break. 


Hello, WorldViewer! 
This is the second page. 


Print this document using Print2Pict and find the scrapbook 
file named {Program}*-Untitled+001 that was created 
(the bracketed “{Program}” is the name of your word 
processing program). 

Rename the file to Hello. Start the ResEdit utility and 
change the file’s creator to 'WVMN' and the file type to 
'manl'. Save the file and quit the application. 
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complete installer in one easy step. 
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Double-click the documentation file Hello from the 
Finder. Figure 5 shows this documentation file opened within 
WorldViewer. 


Hello, WorldViewer! 





Figure 5: The Hello documentation file 


Remember that a documentation file can be created from 
any printable source, including publishing applications, drawing 
programs, and label-makers. With ResEdit and a little finagling, 
'PICT' resources from different source applications can be 
placed into a single WorldViewer documentation file. 


IN CONCLUSION 

WorldViewer was not intended to replace Apple Computer’s 
DocViewer or other documentation viewers, but rather to create 
a home-grown reduced-feature version. As more software 
products are distributed using CD-ROM media and networks, 
the inclusion of on-line documentation will become more 
widespread. For those developers who need an easy (and 
cheap!) method to include their documentation, WorldViewer is 
a solution. Further, the ease with which it was implemented (as 
well as the simplicity of updating for MacApp 3.3, including the 
generation of a FAT binary) is a recommendation for the 
MacApp approach. 
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By Jeremy Smith 








Programmer’s Buying Guide 





The perfect gifts for the 
developer in your life 


Though the holiday season has. come 
and gone, many Macintosh programmers 
are still without some of the 
development treats they were hoping for 
this year. Blame it on oversight, blame it 
on human error, blame it on Microsoft, 
but you or the programmer in your life is 
doubtless still lacking. 

Well, lack no longer. For your 
shopping pleasure, I’ve compiled a list of 
the very best in developer gifts. Some 
are a bit tough to find, however, so start 
shopping now. Remember, you've only 
got 247 shopping days until Christmas. 


Inside Macintosh: On Tape 
Addison-Wesley — $6,499.99 

All your favorites from the Inside 
Macintosh series are now available on 
cassette tapes for your audio pleasure! 
Listen to Toolbox Essentials in the car, 
QuickTime Components at work, and the 
ever-popular Designing Cards and Drivers 
for the Macintosh Family while you're 
hacking around the house. The depth of 
the Inside Macintosh series means the 
tapes number in the thousands, so get 
ready for long, long hours of fun! Series 
narrator: Patrick “Jean-Luc Picard” Stewart. 


Jolt Cola Implants Norplant—- $69.99 

Jolt Cola Implants combine the power of Jolt with the 
longevity of skin implants for the programmer who doesn't 
want to sleep — or even have a moment of calm reflection — for 
weeks at a time. Each implant lasts for over a month of 
debugging fun and comes with its own lengthy legal disclaimer. 
Married programmers considering the implant should consult 
either a marriage counselor or divorce lawyer before using. 


Metrotec Codepacifist White Diamond 
Symantrowerks — $25,000 

Metrotec Codepacifist White Diamond is the ideal gift for the 
developer who has it all. Supporting every programming 
language known to man (ALGOL fans, this means you!), White 
Diamond compiles under everything from BeBox to X-Windows. 
Software is updated every thirty seconds via the Internet, and each 
White Diamond purchase comes with its own 16 gigabyte disc 
array. Be the first on your block to own the White Diamond! 


MacsbugOS Apple Computer, Inc. — $0.99 

Do you resent Calculator’ inability to multiply A9 by C2? Do 
you use stack crawls to proofread your work? Do you yearn for 
command-line input whenever you're stuck in the Finder? If you 
answered “Yes! Yes!” to any of the above, MacsbugOS is the 
operating system for you. The first operating system since MS-DOS 
designed without an interface from the ground up, MacsbugOS is 
for anyone who's ever looked forward to debugging. 


Life 1.0 God - priceless 

With just one copy of Life 1.0, you'll be able to go outside in 
daylight, talk to other human beings, and even turn off your Mac 
for minutes on end. Not for the faint of heart, Life 1.0 is scarier 
than Marathon 2, buggier than Windows 95, and bigger than 
Word 6. From the maker of each and every thing in existence, 
Life 1.0 is something no Macintosh programmer should be 
without. Warning: Life 1.0 is just out of beta, so use with caution! 





Jeremy Smith — Nondescript high school senior by day, playboy mac programmer by night, Jeremy Smith hails from 
Evanston, Illinois. You can reach him at cjsmith@nwu.edu. 
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By Matt Neuburg, Managing Editor, and others 


Mobbing the Moscone 


We came, we sau, 
we conked out 


THE BiG PICTURE 


Macworld Expo was held in San 
Francisco, January 9th-12th, and 
MacTech Magazine was there — to learn 
what was fun and cool, to give away 
copies of the magazine, to sell from our 
Mail Order Store, and to help mind 
Developer Central, the area of the 
exhibition that we sponsor jointly with 
Apple Computer, Inc. A number of our 
associates — contributing editors, authors, 
and the like — were there too, providing 
an opportunity for Your Humble 
Managing Editor to meet some important 
MacTech identities who had hitherto 
been little more to him than a name in a 
byline, on a masthead, or after an email. 
The event was both a barometer and 
a metaphor for the health of the 
Macintosh. Even as major executives 
were resigning from Apple and the 
newspapers were clucking their tongues 
over the company’s weak pulse or even 
tolling its death-knell, users were flocking 
to the Moscone Center in such numbers 
that from opening to closing every day it 
was a struggle to move through the 
passageways between the booths, a 
graphic testament to the ongoing vitality 
of the Macintosh community, at least. If 
we compare the visitors to red blood cells 
and the passageways to veins and arteries, 
one might be forgiven for wondering 
whether the nay-sayers had their fingers 
on the wrong pulse. The irony was 
irresistible, and universally palpable. 
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It was unsurprising that the South Hall should be jammed, 
because that’s mostly where software was being hawked, often 
at considerable savings, and mementos of all sorts (bags, shirts, 
removable tatoos, little rubber brains) were being given away. 
More remarkable was that Developer Central, in the North Hall, 
was every bit as crowded. Of course, not all visitors knew what 
they were getting into. We saw one pair scratching their heads 
in confusion: “What is this place? What are these people 
selling? Wait! I know! They're geeks/ Let’s get outa here!!” But 
an amazing number of people did actually want to see what the 
“geeks” had to offer, and our folks were run off their feet 
keeping up with the demand. 

Your Humble Managing Editor, too, proceeded to join the 
crowds and brave the madness of the South Hall. He had never 
seen a MacWorld Expo before, and, scouting for software deals 
and buying himself a few utilities, and seeing in person, as it 
were, software companies whose products had long been old 
friends, he felt as if he had died and gone to Mac heaven. 

When he got past the kid-in-a-candy-store phase, though, 
he found that there were also a number of things in the South 
Hall directly germane to MacTech Magazine. For one thing, 
there was a BeBox in action (see MacTech 12.1 [January 1996] 
25-45), showing off its way cool GUI (from which Apple might 
take a few lessons) and its speedy double processor — though 
intrepid reporter and Editor-at-Large Eric Gundrum felt that the 
blue, red and white box was “hideous”. He also had this to say 
about the state of play with the BeBox: 


The OS is speedy and modern, but the APIs are a bit 
rough and lack consistency. It also lacks any interface 
guidelines, though there isn’t yet enough software for 
this to matter. Compiling on Be is sweet. No longer do 
we have to go out for coffee when starting a lengthy 
compile; the machine just shunts it off to one of its two 
603s and allows real work to continue on the other CPU. 
It doesn’t yet compile for Macintosh targets, but we can 
hope it will soon. The device could be a hacker’s dream 
come to life. Only time will show if it will represent a 
viable market worth developing for. Seeing the BeBox 
caused more than one developer to reminisce about the 
early days of Macintosh. 
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For C and C++ Developers .... 


When the Text 


Are you writing a... 
* Document Viewer? 
¢ Multimedia Product? 
* Report Generator? 
* Forms Package? 
* HTML Editor? 
¢ Email Application? 
¢ Electronic Book Technology? 
¢ Hypertext Enabled Program? 
¢ Program with text features? 


Then you need PAIGE. 

PAIGE™ is a library of run-time 
functions you can embed into your 
application. It will add virtually unlimited, 
programmable “rich edit” word processor and 
page layout features to any part of your program. 


PAIGE will save you hundreds of precious development 
hours. Better yet with PAIGE’s cross-platform API you can 
support the most popular desktop operating systems. 


is not Enough. 


PAIGE is the solution when 
ther “edit” controls fail. 


IGE Features 


Call: 800-327-6703 


DataPak Software Inc. 


Internet: sales@datapak.com CS: 76424,3027 
URL: www.datapak.com/~ datapak AOL: DATAPAKI1 


Ph: 360-891-0542 
Fx: 360-891-0743 


Windows 3.1 « Windows 95 ¢ Windows NT « Macintosh ¢« PowerMacintosh 


Some HyperCard folks were present, and gleefully feeding 
the rumour mill: the program is to be rewritten from the 
ground up, in color, and cross-platform. But Apple continues 
to market HyperCard as geekware, unfortunately, representing 
it with such arcane terminology as “tool for creating software 
solutions”, when what it really is, is Mac programming for the 
rest of us; whether, as part of this makeover, they will wake up 
and restore HyperCard to the flagship position it deserves, 
remains to be seen. General Magic was represented by Sony 
with its Magic Link communicator, as well as by Contributing 
Editor Richard Clark operating out of the Metrowerks booth in 
Developer Central. Mainstay was showing off the latest 
versions of VIP-BASIC and VIP-C (see MacTech 12.3 [March 
1996] 14-24), and its many other programs, such as its database 
app, Phyla, as well as Plan&Track, Marco Polo, and others. 
Allegiant, along with its SuperCard, was also showing Marionet, 
its faceless app and XCMD for scripting Internet protocols, 
which had just come out of beta. 


BACK To DEv CENTRAL... 


It was, however, at Developer Central that the principal 
denizens of MacTech Magazine were mostly in evidence. The 
avowed purpose of Dev Central is, after all, to showcase the 
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latest in developer tools and services, as well as to educate the 
public and one another. It also gives developers a powerful 
platform from which to make exciting announcements — of 
which this MacWorld Expo had its fair share, as we shall see if 
we just take a walk around Dev Central. Imagine an area of 
roughly 11,000 square feet, inhabited by some 39 companies, 
with perhaps 20,000 visitors coming through over the four days. 
You might also like to imagine Your Humble Managing Editor 
(a diminutive fellow to start with) crushed in this crowd, and 
competing with it, not always successfully, to visit the various 
booths and learn what was happening. 


Apple and Company 

Apple Computer, Inc., was of course very much a presence, 
showcasing present and future technologies for developers to 
write for, as well as tools for helping them do so. For instance, 
Newton 2.0 was backed up by the Newton Toolkit 1.6. There was 
info on Apple Media Tool 2.0 (as well as ScriptX, acquired from 
the collapsed Kaleida), on Apple Guide, on Dylan, and so forth. 
And there were the familiar catalogues of products and developer 
courses from APDA — whoops, I must try to remember to call 
them “Apple Developer Relations” now (though much of Apple’s 
own literature has neglected to make this change, I noticed). 
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Think C, CodeWarrior C, CodeWarrior Pascal, MPW C (68K or PPC) 


Think Pascal, MPW Pascal, Prograph CPX (68K only) 

68K StoneTable $150 StoneTableExtra $50 (per compiler) 
PPC StoneTable $100 StoneTableExtra $25 (requires 68K) 
International shipping (US Airmail) $10 

No royalty fees for applications 


CodeWarrior C package includes PowerPlant Class 


Demo - ftp://ftp.teleport.com/pub/vendors/stack/StoneTableDemo.hax 


Break on through the limitations of the List Manager 
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Portland, OR 97232 


StoneTablet Publishing 


voice/fax (503) 287-3424 


StoneTable 

Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 

edit cells in place 

validate data entry through callbacks 

set font, size, fore/back color, face, alignment per cell 
cell margins, top/bottom & left/right 

68K support for both A4 and A5 worlds 

“LDEF-like” custom drawing function 

greater than 32K data per table 

plus all List Manager functions and more 


StoneTableExtra 

drag cells in and between tables 
PICT support 

popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 

controls in cells 
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Portland, OR 97212 
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Quite aside from its own alphabet soup of development 
tools (the ETO, Mac OS SDK, MPW, and ODF), Apple also 
hosted a number of companies whose products pioneer its 
advanced technologies. The largest range of these was in the 
OpenDoc category. For instance, we saw Oberon/F, an 
applications development environment (using the Oberon 
programming language) from the Swiss company, Oberon 
microsystems, Inc.; this environment is itself not just object- 
oriented but component-oriented, making it ideally adaptable for 
generating parts for OpenDoc. Many companies, such as Ware 
Corporation, are forging ahead with the production of powerful 
parts. A fascinating and forward-looking product comes from 
Kantara Development: PM Finder is an OpenDoc plug-in (like an 
extension) which, when you open a document containing a part 
for which you don’t own an editor or viewer, will put you onto 
the Web and show you where you can obtain it. 

Naturally, Apple’s own Cyberdog was also displayed. Our 
intrepid Contributing Editor for the Internet and reporter on the 
scene, Jon Wiederspan, reports: 


Without a doubt, the coolest thing at the entire MacWorld 
show was OpenDoc, and for my part it was specifically 
Cyberdog. Cyberdog is a set of OpenDoc objects that 
provide TCP/IP client capabilities. Think of it as “Internet 
everywhere”! Your document can have FTP links or WAIS 
queries just as easily as it can have graphics or text. 
Cyberdog is a 180-degree reversal of the current trend on 
the Internet toward monolithic, do-it-all browsers, and it 
clearly shows why Apple remains the technology leader 
in desktop computing. Other companies are giving you 
access to the Internet, once you learn how their software 
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works. Only Apple is bringing the Internet into the 
environment that you already know, making it a natural 
extension of your current work habits. Unfortunately, 
Apple failed to recognize the power of a Cyberdog 
demonstration for non-programmers, so it was only on 
display in the far reaches of Developer Central, well out 
of sight of the majority of MacWorld attendees and even 
the casual Dev Central visitor. 


Programs making extensive use of AppleScript technology 
were also featured. B&E showed Ragtime, an integrated 
document processor (word processor, spreadsheet, etc.) that 
uses AppleScript as its internal command language, making it 
scriptable, recordable, and attachable. Similarly, E-mailer, a 
program being developed by Connectsoft based on its E-mail 
Connection (for Windows), makes heavy and powerful use of 
AppleScript. QuickDrawGX was featured in a similar way; we 
saw a page layout program, UniQorn, by SoftPress, that should 
have shipped by the time you read this, and uses QD GX 
extensively — one of the first commercial programs to do so. 

OpenTransport, QuickDraw 3D, and QuickTime were also 
featured; but, as noted by sharp-eyed roving reporter Eric 
Gundrum, PowerTalk was conspicuous by its absence. Eric 
writes: “Word on the floor was that Apple has decided to rethink 
its PowerTalk strategy, and PowerTalk is not likely to survive in 
the form we've known it. Instead, Apple will be breaking out 
the useful technologies into separate packages, and offering a 
more open architecture for developers to take advantage of.” 

Eric also had the following to say about Apple’s TV- 
oriented technologies, the Set Top Box and Pippin: 
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The technology of the Set Top Box is still in the proof- 
of-concept phase and not expected to be released until 
at least next year. That is, Apple doesn’t seem to have 
many content providers (cable TV companies) lining up 
to license it. This device is essentially a PowerPC 
converted into a cable TV tuner. It offers many more 
features, but without content providers supplying the 
necessary signal, it won’t do much. 


Pippin is much more interesting. It is much like a Mac 
stripped to the bone. For under $600 you get a box that 
uses your television set to display a minimalist 
Macintosh interface and run Macintosh software. Pippin 
doesn’t have a hard disk, so the OS must reside on the 
CD-ROM that also contains the software. Technically 
speaking, the software could be any Macintosh program, 
but developers will want to make a few minor changes 
to work better with Pippin’s limited RAM, lack of hard 
disk, and the lower quality TV display. With those 
software changes, Pippin could be considered another 
outlet for Macintosh software. 


The Big Two, and Several Others 

Development environments are like worlds of their own, 
so Dev Central is a world of worlds. With regard to space and 
sheer physical presence, the Jupiter and Saturn of this solar 
system were, as one might expect, Symantec and Metrowerks. 
The latter especially pulled off a coup by providing several 
leather sofas, which immediately became a focal refuge for the 
footsore (meaning absolutely everybody). 

Symantec were crying up a whole raft of releases and 
plans. Among them: Release 5 of their C++ 8.0 will add Apple 
Guide tutorials and support for drag-and-drop text editing. 
Their drop-in translator standard allows the user to take 
advantage of Apple’s MrC and MrC++ optimizers. In the 
VaporWare category, there is hope that Symantec will pick up 


Language System’s LS Pascal somehow, thus bringing Pascal 
support back into their suite of compilers. And in the 
AromaWare category, there was Café, their Java environment 
(formerly Espresso) which, when it appears, will be free to 
current subscribers. 

Meanwhile Metrowerks’s CodeWarrior 8 fights back with 
such things as tools for BeBox development, MagicCap, and, 
despite the power of its editing and debugging tools, a fairly 
small RAM footprint (minimum, 8MB). Two huge books 
provide paper documentation and instruction for CW8 and 
PowerPlant. The new CodeManager is a source code control 
system (based on Microsoft Visual SourceSafe) which works 
with any type of file. And, besides their present Academic / 
Bronze / Gold trinity of levels, there is now “Discover 
Programming for Macintosh”, a complete working copy of CW 
68K plus a set of books online, including the new 2nd edition 
of Learn C on the Macintosh by Dave Mark, The Programming 
Starter Kit for Macintosh by Jim Trudeau, Learn C++ on the 
Macintosh by Dave Mark, From Mac to Windows by Steve 
Chernicoff, and two others, plus Apple Guide files to help you 
navigate the materials; the remarkably low price is deductible if 
you then upgrade to CW Gold. 

An alternative way to get your app up and running is to 
draw it and generate the resulting shell code using AppMaker, 
in some ways the granddaddy of interface designers. It’s from 
Bowers Development Corporation, and Spec Bowers himself 
was showing it off, call me sentimental, but I think there’s 
something mighty impressive about watching a demo given by 
the guy whose name appears on the box (. infra, “Jasik”). 

Motorola were showing their new C/C++ and Fortran 
SDKs; these compilers are ready now, but there is some hope 
that they may appear as drop-ins to some other development 
environment (such as Symantec’s) later this year. 

In today’s volatile computer market, cross-platform 
programming is becoming an increasingly important strategy. 
Microsoft were demonstrating their solution, in the form of Visual 





Dilbert® by Scott Adams 


CHANGE FOR THE SAKE OF PROMOTION 


WE'VE 60T TO DECENTRALIZE 
JO REMOVE THE BOTTLENECKS. 


YOU WILL APPEAR To BE A 
VISIONARY PLANNER IF YOU 
DECENTRALIZE EVERYTHING 
WHICH IS CENTRALIZED 
AND CENTRALIZE EVERY- 
THING WHICH IS DECENTRAL- 
IZED. 

( OR6 CHART 


Apri, 1996 @ MACTECHMAGAZINE 






ScottAdams@aol.com 





ONE YEAR LATER 


WE'VE GOT TO CENTRALIZE 

TO BE MORE EFFICIENT. 
THE MAN ISA 
MANAGEMENT 
GENIUS. 


© 1992 United Feature Syndicate, Inc. 


Reprinted by permission of UFS, Inc. 


MOBBING THE MOSCONE 





BUILD UPDATERS 





WITHOUT PROGRAMMING! 


PALCHWOIHS PO 


PatchWorks Pro has many options, but only one function: to 
create small, stand-alone Updater Applications which field- 
upgrade your products to newer versions. Updaters can be 
freely and safely distributed online, since they are only of use to 
end-users who've already purchased your software. 


UPDATERS ARE FAST, 
SAFE & EASY FOR END-USERS 
Your end-user just downloads and runs the Updater. The 
Updater prompts the user for the original software via a “Get 
File” dialog box (if not in the same folder as the Updater). 
When the user clicks the “Update” button, the original software 
is updated immediately. 


Uery high w 


<5 ‘Build Updater 


UPDATERS ARE CREATED IN MINUTES! 
Why tie-up valuable programming time building updater 
applications? Just fill in a dialog, and PatchWorks does the rest! 
Since there’s no coding or scripting, no bugs are introduced. 


¢ Works with apps, INITs, cdevs, fonts, drivers, etc. 

¢ Works on resource and/or data forks 

° Full support for PowerPC and fat binaries 

¢ Updaters support multiple “old versions” 

¢ Preserves personalization data (name, serial #, etc.) 

* Customizable end-user interface 

* Updaters can execute custom CODE resources 

° Intelligent diff-ing produces small Updaters 

¢ Distribution of Updaters is unrestricted and royalty-free! 


NOW AN INDUSTRY STANDARD 
AFTER FOUR YEARS ON THE MARKET 
PatchWorks Pro is used by Macintosh publishers such as: 
Apple Computer, Adobe Systems, MacroMind, Now Software, 
Symantec, WordPerfect, and many more. Pricing begins at $195. 
Download a fully-functional trial version from our web site: 
“http://www.broadcastsoft.com”, or call us at (407) 241-0308. 


BroadCast Software Corp 
East: 407-241 0508, Fax: 407-241-3195 


West: 503-317-0429, Fax: 503-317-0430 
Net:  http:/Avww. broadcastsoft.com 
Email: info@broadcastsoft.com 





MOBBING THE MOSCONE 








C++ 4.0 running on a PC. This, we are told, is the program that 
Microsoft used in-house to make the current versions of Excel 
and Word. An alternative approach was offered by Willows 
Software, Inc., who supply a development toolkit incorporating 
the Windows API; from one set of sources you can build for Mac, 
Windows, OS/2, and Unix. They told me they were just now 
getting around to providing Mac look-and-feel. 


Different Strokes 

Not everyone wants to program in C or C++, though, or 
even Pascal; and a healthy sampling of alternatives was on 
display, to get you talking another language (and living in yet 
another world). Fortran put in a strong showing with Absoft’s 
development kits. There was also Macintosh Common Lisp, an 
important Apple in-house tool (it’s what was used to write 
Dylan) now owned by Digitool, Inc., whose ports of both MCL 
and Dylan to the PowerPC are significant as well. Smalltalk was 
represented by Quasar Knowledge Systems, Inc., with 
SmalltalkAgents. And UNIX-heads could experience Tenon 
Intersystems’ various levels of MachTen, including the version 
for PowerPC. 

Pictorius, Inc., had a booth directly across from ours. 
Besides showing off their own remarkable Prograph visual 
OODL and Peregrine client/server database development tools, 
they were hosting some powerful third-party add-ons. One was 
Breathing Software’s lively animation classes and editors, 
Animation Solutions, which bring multimedia authoring to 
Prograph. The other was from Everyday Objects, who have 
written a set of internet-protocol classes; by combining these 
with Peregrine and a dtF database, they had written an internet 
server which, when a client such as Netscape polled it, fetched 
the required information from its database, built a GIF around it 
and an html page around that, and returned the html page to 
the client. Very exciting. 


Caught in the Web 

Whatever the future of the Web, it (and the Internet in 
general) certainly has generated an excitement which has 
become the driving force behind the creation of many new 
development tools. As correspondent Jon Wiederspan writes: 
“Everyone [at the Expo] was eager to display a link from their 
product to the Internet, no matter how far-fetched — the ability 
to export images in GIF format now makes software ‘Internet- 
enhanced!’” Besides the Web server created entirely with 
Pictorius’ Prograph language, web-heads in Dev Central were 
also thronging to look at Everyware’s database front-end, 
Tango. Interface Builders were demonstrating their Online 
Workshop, which lets online providers design and implement 
their own interface (essentially allowing you to become your 
own Compuserve). 

The really big Web buzz (might we call it a caffeine buzz?) 
came from Natural Intelligence, which announced not only the 
initial release of its Roaster environment for making Java 
applets, but also its plans for Roaster Professional, which is to 
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create applications in Java. The attention from press and public 
lavished on Natural Intelligence was quite tangible, and indeed 
left little room for folks to visit our Online Support expert, John 
Kawakami, at his booth across from theirs. Here’s Jon 
Wiederspan’s report: 


Natural Intelligence releases DR1 of Roaster, their Java 
development environment. With this, NI was not only 
the first to announce but also first to fulfill their promise 
to bring the joys of Java to the Macintosh. Unlike the 
products arriving from Borland, Symantec, and 
Metrowerks, NI is producing an entirely new 
environment for Java work, and they feel that this is 
what will differentiate their product. NI took hits earlier 
in Java newsgroups from people worried about the fact 
that NI was not actually licensing Java from Sun, but 
those worries appear to be unfounded. According to 
Hillel Cooperman, Director of Business Development for 
NI, Sun has shown great interest in their environment 
and has already promised complete support for their 
developers. Given the fact that Sun has promised to 
eventually release Java as an open standard, there seems 
to be little reason for licensing in the long run. 


By the same token, the two competing makers of 
alternatives to Apple’s own AppleScript Script Editor — Late Night 
Software Ltd., with Script Debugger, and Main Event Software, 
with Scripter — might have been expected to be plenty busy as it 
was, with users becoming more and more interested in 
AppleScript, and more and more apps letting them take 
advantage of its power. But thanks to the excitement generated 
by the Web, Main Event also found itself quite busy fielding 
questions about Dogpatch, a new solution to the threading 
problem with CGIs which allows the CGI to run on a different 
machine from the server. Here’s more from Jon Wiederspan: 


One of the main drawbacks of using AppleScript for 
creating CGI applications has been the problem of 
handling multiple incoming events. AppleScript handles 
new events as soon as they are received, even if they 
supersede older events. On a busy system, this could 
result in a CGI that was never able to finish processing 
an event because new events would always be 
interrupting. Until now the only solution was to use 
FaceSpan by Software Designs Unlimited to create the 
CGI application. FaceSpan takes over processing Apple 
events and forces them to be processed in FIFO order. 


Main Event Software, creators of the Script Editor 
replacement Scripter™, announced their answer to the 
multiple event problem. Dogpatch is an Apple event 
dispatcher that can sit between a Web server like 
WebSTAR and a CGI application. Dogpatch doesn’t just 
force events into FIFO order. It also allows you to create 
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multiple copies of a CGI and have events handed off to 
them in a variety of sequences (round-robin, least 
recently used, and more). This reduces the load on any 
single CGI, so threading is less of a problem. Dogpatch 
can be used with any CGI, not just those written in 
AppleScript, and it can send the events across an 
AppleTalk network so CGI processing can be handed off 
to other CPUs without requiring another Web server to 
be running. The result is effectively a better CGI 
interface for Macintosh Web servers. 


While there were no official new announcements from 
Late Night Software, the booth staff did let me know that 
they are working on their own solution to the multiple 
event problem. The Script Debugger focus will be on 
improving the compiled applications that are produced 
from AppleScript. In future versions, users will be able 
to choose whether to compile like Script Editor or to use 
the new Script Debugger compiler which will provide 
FIFO event management and multi-threading (processing 
multiple events simultaneously). 
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A Cast of Dozens 

Developers and programmers can find all sorts of tools 
and support, and Dev Central is the place to find them. Here 
are some more of its inhabitants. 

Databases and client/server applications to access them are 
a major obsession of businesses everywhere, and tools for 
building solutions. are ready to hand. OMNIS, in its various 
“editions” from Blyth Software, provides some serious cross- 
platform capability. JYACC, too, were showing their cross- 
platform client-server app builder, JAM; version 7 is “Pre-Release” 
as I write this, but should be moved to “General Availability” by 
the time you read it. dtF Americas, Inc., displayed dtE, their 
powerful relational database front end. Planning Sciences, Inc., 
exhibited Gentium, and Oracle showed Developer/2000, both 
mighty client/server design and development tools. 

Aladdin Systems was displaying its Stuffit Installer Maker 
2.0.2, a version which reportedly has improved scripting and 
can build multi-file updaters. MindVision Software, had its 
installer, Installer VISE, as well as its new Updater VISE and the 
newly acquired TMON debugger (the Professional 4.0 version, 
with numerous changes to support PowerPC, should be out of 
beta by the time you read this). Competing in the debugger 
category was Steve Jasik in person, with The Debugger and 
MacNosy, including his new “SoftMMU” feature. And 
Mathemeesthetics was present, with Resorcerer 1.2.5. 

For those who feel the need for speed, DayStar Digital 
were showing their multi-processed clone, the Genesis 
machine, plus their MP API; beside them, Emerson Kennedy 
had their PowerTap software, which lets you multi-process 
using ordinary machines over a network. (See MacTech 12.3 
[March 1996] 46-54.) 

Conveniently located next to Apple’s own Apple Guide 
station was guideWorks, LLC, consultants and makers of Apple 
Guide solutions; among other things, they showed off guideWorks 
Translator, a tool that converts Apple Guide source files to 
Windows Help source files. Rainbow Software demonstrated their 
software protection devices. Bare Bones Software was there with 
BBEdit 3.5.2 and their t-shirts, always in demand (“it still doesn’t 
suck”). Terran Interactive showed their video compression tool, 
Movie Cleaner Pro. Adobe had a station representing the Adobe 
Developers Association, where one could inquire about the SDKs 
for Acrobat and for Illustrator or Photoshop plug-ins. Stone Tablet 
Publishing demonstrated StoneTable, their List Manager substitute. 
Douglas Electronics were there with Douglas CAD/CAM. And 
Scientific Placement, Inc., were providing information on their 
developer job-hunting services. 


Editor’s Choices 

Now that we’ve explored Dev Central, let’s finish by 
strolling back out and visiting the rest of the floor once more, to 
look at those things which particularly interested our roving 
reporters at MacWorld Expo. First, Contributing Editor Jon 
Wiederspan, who, as might be expected, spotted all sorts of 
Web-related material that the rest of us didn’t even know about... 
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JON WIEDERSPAN’S TOUR 


Databases and the Web 

Everyware Corporation announced two new products, 
Bolero and Tango ODBC, based on their popular Butler SQL 
database. Bolero takes advantage of a feature of WebSTAR, the 
HTTP server from StarNine, to receive log data directly from 
WebSTAR and insert it into a Butler database. The data is 
compressed on receipt by replacing redundant data so the 
database will be only a fraction of the size of its text log file 
equivalent (busy web sites can have logs measuring over 
100MB/month!). Bolero comes with several of the report 
formats most commonly needed by sites, and new reports can 
easily be generated. With this solution, reports can be made 
available on-the-fly, and can be customized for the needs of 
each different department. Tango ODBC extends the Tango 
CGI to connect to ODBC databases, including Oracle, Sybase, 
SQL Server, FoxPro, and Butler SQL ODBC (also to be released 
this month). The Tango CGI provides a graphic interface for 
easy building of query documents for accessing databases via 
Web pages. With the addition of ODBC support and the ability 
to access database servers over TCP/IP, Tango makes it very 
simple to provide cross-platform access to your databases 
wherever they reside. 

Heyertech Inc. was displaying their new product for Web 
site development. With WebMaster Pro, the entire site 
(graphics and all) is kept in a database. This reportedly makes 
it much easier to make global changes and keep track of 
internal links, reducing errors in site development. The 
database runs as a pre-processor under WebSTAR so there are 
no actual files on the server, only the database. WebMaster Pro 
includes a flowchart for designing a site, a template database, 
and built-in imagemap processing. 

SuperNova from Purity Software Inc. is a multi-user 
database that is designed specifically for access and control 
through Apple events. The database is fully threaded and 
PowerPC native and includes a C-language API. WebSiphon is 
a CGI application that uses template files to produce dynamic 
HTML pages on demand. The templates can substitute 
variables, conditionally include or exclude portions of a 
document, and much more. WebSiphon interfaces directly to 
SuperNova to provide persistent storage for the CGI. 

Foresight Technology, makers of the NetLink/4D software 
that turns your 4D database into a CGI application, 
demonstrated their new scheduler for the Web. 
CalendarSet/CGI displays clickable calendars in any Web page, 
complete with banners, icons, and an unlimited number of 
events. Calendars can be displayed in multiple views and can 
be secured from public viewing if desired. Installation is very 
simple and there is a complete graphical point-and-click 
interface for quickly creating and maintaining an unlimited 
number of calendars. 

Interactive Catalog Corporation is a new company formed 
by several ex-Aldus engineers. Their first product, iCat, creates 
catalogs that can be easily exported to HTML or CD-ROM from 
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one central database (CD-ROM support due later this year). 
This same database is used by the iCat Commerce Manager, 
which operates as a CGI application on your Web server to add 
shopping cart functionality and online purchasing to the catalog. 

WebCatalog, from Pacific Coast Software, makes it very 
easy to add a searchable catalog to your Web server, including 
“shopping cart” functionality and graphics. WebCatalog 
provides very flexible searching of the catalog and will also do 
a ranking of multiple term searches much as Lycos™ does. 
Pages can be formatted to match the user’s browser 
capabilities, returning tables only to table-enabled browsers. 
The catalog database can be built from any tab-delimited text 
file or even from Quark XPress documents. The catalog 
database is cached in RAM on the server to provide optimum 
search performance. In a move to keep up with the times, 
WebCatalog also allows you to include advertising that 
automatically changes as people visit your site multiple times. 

WebSite Searcher is the first of several products from 
Blueworld Communications that uses Frontier to interface with 
FileMaker Pro 3.0 databases. WebSite Searcher provides users 
with a very fast search of the contents of your Web site so they 
can find exactly the pages that interest them. The load on your 
site is very low and indexing of files occurs in the background 
without decreasing performance. 
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VRML 

3-D is a hot Web topic and there was plenty of activity on 
that front. First, Apple announced plans to make the 3DMF 
format a standard on the Internet for 3-D graphics. 3DMF has 
many advantages over VRML, primarily that VRML is not really a 
suitable format for direct storage of 3-D data. Two VRML 
browsers were announced as well. The first is from North Plains 
Systems Inc. and is called VRML Equinox. This product supports 
the entire VRML 1.0 specification, has an easy to use control 
palette, and views (and converts to) both VRML and3DMF file 
formats. It can also handle WWW Anchors, allowing objects to 
be links to the Internet for creating 3-D data browsers. The 
second is Virtus Voyager, a 3-D viewer from the makers of the 
Virtus Walkthrough 3-D modelling application. Like VRML 
Equinox, Voyager operates as a helper application for your Web 
browser and provides walkthrough capabilities for VRML files 
including URLs embedded in objects. Instead of 3DMF, Voyager 
adds additional support for VMDL, the Virtus Modelling 
language. Virtus also announced a simpler version of 
Walkthrough Pro called Virtus VR that allows users to drag and 
drop pre-made 3-D objects and link in URLs to create VRML files. 


Web Servers 


As you might suspect from the name, Web Server 4D is a 
complete HTTP server built on a 4D database. All of the basic 
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features are there, including imagemaps, basic security, and 
several extensions as well such as active text (inserting counters, 
time, date, etc.), SMTP mail client, and the ability to listen on 
multiple ports at once. In addition, all logging information is 
included in the database so users can create custom reports. 
There is also a Web Server 4D Developer which adds the 
uncompiled 4D code for customization of your server. If you 
are planning to integrate a 4D database with your Web site, this 
solution can be much faster than a CGI interface. 

Delphic Software again announced a complete line of 
Internet server software, this time changing the name from 
NetAlly to OneSite. The Web server has been promised for 
beta release by the end of February and surprisingly is going to 
be free. No date was set for the other servers. 

Spider Island Software announced that version 5.0 of their 
BBS server now also includes HTTP and POP3 server 
capabilities. The HTTP server is reportedly faster than 
MacHTTP (interesting that they didn’t compare it to WebSTAR), 
supports CGI applications and allows an unlimited number of 
simultaneous Web connections (a neat trick). Probably the 
most desired feature, though, will be the ability to create 
“virtual hosts”, allowing different home pages to be assigned to 
different domains on the same server machine. 


More Cool Stuff 

Intelligence at Large Inc. was demonstrating a CGI 
application/server combination that allows live video to be 
delivered through a Web interface. The CGI application 
MovieStar Server displays the live video by using server-push to 
send frames to the client’s browser. For better performance, 
the client can click on the frames and launch a free viewer that 
will connect directly to the MovieStar Server and display live 
video. MovieStar Maker is a simple drag-and-drop interface for 
creating multimedia files that can be saved out either as 
QuickTime movies or a multi-part MIME file. The latter format 
allows the animation to be played immediately as quickly as it 
can be downloaded by the browser. 

WebAnimator, from DeltaPoint Inc., creates multimedia 
files complete with sound and animations that will play on the 
client machine. DeltaPoint provide a free plug-in and a stand- 
alone player, both of which are freely distributable. 
WebAnimator uses vector-based objects to decrease the size of 
files (as opposed to bitmap images) and has four soundtracks 
that can be synchronized with animations. 

Lundeen & Associates were displaying Web Crossing, a 
CGI application that provides discussion forums on Web sites. 
The forums are structured hierarchically into various topics with 
threaded discussions (“conversations”). Topics can be limited 
to private viewing only or open to the public. Users can create 
new topics and conversations so they forum grows according 
to user interests. Users can also selectively view only those 
postings that they have not read yet and can optionally include 
a small picture to associate with their postings. Web Crossing 
works with any browser and is available on all platforms. 
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Little utilities (sometimes not so little) for organizing your 
URLs are popping up everywhere. All of them store URLs in an 
easy-to-search hierarchical structure and provide simple methods 
adding and using the URLs. Each also has its own take on what 
is an easy interface so you pretty much have to try them all and 
pick the one that works for you. Dragnet from OnBase 
Technology Inc. provides several interfaces for collecting URLs, 
e-mail addresses and more. There are user customizable hotlist 
menus, a searchable index, and a Finder-like window of folders. 
WebArranger from CE Software Inc. is an update of their existing 
information management software to add URL support. You not 
only get storage of URLs and other Internet information, but a 
complete contact database, calendar application, and more. On 
the down side, WebArranger works best at full screen on a 15- 
inch monitor and requests 3 MB of RAM. On the up side, it was 
being given away free. CyberFinder from Aladdin Systems Inc. 
takes a different tack and uses the Finder to store URLs and other 
information bits. URL links look just like files on your desktop 
and can be organized into folders like any other files. This is 
very handy if you get tired of having to juggle a dozen or more 
“useful utilities” and their respective windows. 


ERIC GUNDRUM’S TOUR 

One of the most curious products at MacWorld Expo was 
Executor, by a startup company called Ardi. Executor is a 
clone of the MacOS running on a Pentium. The software is 
pre-beta, and doesn’t support I/O or most System 7 features, 
but it does run many 68K Macintosh applications, including 
many from that company in the Northwest, and it runs them 
faster than any Macintosh. Executor is intended for the 
corporate environment that is phasing out Macintosh but isn’t 
ready to spend much money upgrading to all new Windows 
applications. Any company so cost-conscious should know 
that the Wintel platform is more expensive than Macintosh. 

PowerComputing gets the award for best aisle-blocking 
booth. They built a large stage backed by a tower of video 
monitors. Then Bob LeVitus got up and emceed “MacJeopardy”. 
Bob had some wonderful ancient Mac trivia questions. He did a 
great job getting the crowd worked up about winning a 
PowerComputing Mac. People were crowded around 15 to 20 
deep and raising their hands with a wide variety of objects. 
Contestants were chosen by how interesting was the object they 
held up. People held up hot dogs, hats, money, small children, 
and just about anything else they could think of. 

Elsewhere on the entertainment front were the Macintosh 
games. It seems there were many more games being shown 
this year. In fact, an editor of a popular video game magazine 
reported that 90% of of the game developers she knows do 
their development for other platforms on the Mac. With the 
right support from Apple, it is only a matter of time before 
many of those games can also be played on Macintosh. Best of 
all was the CH Products booth with Thunder seat and game 
pedals, throttle, joy sticks and other controls. It is not quite 
virtual reality, but they are getting close. 
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ADInstruments, 





| Can you spot 
‘the difference’? 


Plenty of people can’t. Because whether you update software with a 
full set of program disks, or a file made with UpdateMaker 2, the result 
is the same, Guaranteed. UpdateMaker updates are totally reliable. 
Its system of 32-bit checksums ensures that it updates the right file. 


And UpdateMaker is easy-to-uSe - simply specify the files and 
UpdateMaker builds the update. There is no scripting or use of 
ResEdit. It’s even easier for end-users — just one button to press. 


UpdateMaker 2 works with any type of Macintosh file. The updater 
files are extremely Compact. And the program options numerous. 
You can preserve or override user customisations. Save files in Binhex 
format. Update up to 20 old versions with one file. 


The real difference is the savings in time and money. Which 
explains why some of the best-known names in software 
development have already discovered UpdateMaker 2. 


Distribution is unrestricted and royalty-free. 


Only $225, order now, fax (415) 964 2886 


Applelink:MacLab007 Internet:MacLab007@AppleLink.Apple.com 


UpdateMaker 2 


2225 Grant Road, Suite #4, Los Altos, CA 94024 Phone: (415) 964 2878 








For years NoRad Corporation has been making devices to 
detect and shield against various CRT display radiation. Now 
they have a device that has a more pratical use: the JitterBox. 
Have you ever noticed a slight wobbling on the Mac screen 
when you place two displays close to each other? This occurs 
because the frequencies of the displays interact with each 
other. The JitterBox is designed to protect the video monitor 
from outside interference such as this. The JitterBox can seem 
a bit expensive, but NoRad has a less expensive alternative, the 
ELF ProTech, a pair of carefully designed metal belts that fit on 
a monitor to reduce its ELF emissions. With the correct 
configuration, the ProTech can prevent one display from 
causing jitter in another. 

For those who want to get away from CRTs altogether, there 
were a number of new projection LCD displays shown. Until 
recently, projection LCDs were limited to 640 by 480 pixels. 
However, all the vendors were showing 1028 by 768 pixel units, 
and Sharp was showing a full 1280 by 1024. Unfortunately these 
devices remain extremely costly for the present. 

Still in the area of Macintosh displays is NSC Software 
Construction’s PowerPC-native screen saver, ScreenLight. No 
INITs required, and a open plug-in architecture makes this a 
viable platform for developing new screen saver modules. If 
you are interested in exploring what you can put on a PowerPC 
screen during idle time, check out ScreenLight. 
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ALL BUGS ARE STUPID. 


But spending tedious hours trying to track them down is dumber still. 
Why not let a tool do the work? QC can find many of those mistakes | 
automatically. Ever write data beyond the end of a memory block? 

Ever rely on a handle that was purged? Ever call DisposeHandle on a 
resource or ReleaseResource on a handle? Sure you have! Maybe you 
just haven't found out about it yet... QC finds these errors and more. 


BECAUSE: 
Every programmer makes mistakes. 
All programs ship with bugs. 
Marketing just cut the beta. 
You could use some sleep. 


YOU NEED: 


QC is cool and, unlike other development tools, QC is easy. Try it FREE: 


|. Connect to our web site 

poms Boy 71) foy-(e OL Om ((- nar 4010),@) 
3. Send us email to get a serial # 
4. Run the installer 

5. Run your program 

6. Press shift-option-q 


“I only have 6 non-Apple Control Panels on 
my development machine. QC is one of 
them. ‘Nuff said.” 
-Bill Goodman, Compact Pro author 


“We wouldn't ship a product 
without QC's approval.” 
-Mate Gross, Claris Corporation 


NOW POWERPC NATIVE ! EXISTING USERS UPGRADE FREE! 


Onyx Technology 7811 27th Ave Bradenton, FL 34209 
Tel: 941.795.7801 Fax: 941.795.5901 

Web: http://www.std.com/onyxtech/ 

AOL: OnyxTech AppleLink: D2238 CIS: 70550,1377 
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UNIVERSITY 





It’s not just the basics anymore ! 


Advanced courses from Developer University 
get you up to speed quickly on new Apple technologiess 


1 OpenDoc 
_I PowerPC 
_I Newton 


4 Graphics/Imaging 





1 Apple Guide 


Courses Available as 


= & 


Self-Paced Classroom lective Online 




















For more detailed information, check out our World Wide Web pages, 
http://www. info.apple.com, or contact the Apple Developer University Registrar 


at (408) 974-4897 or fax (408) 974-0544. 


Developer University, Apple Computer, Inc. 1 Infinite Loop, MS 305-1TU, Cupertino, CA 95014 
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If you spend a lot of time on the road, you might consider 
the Ricochet wireless modem. For a small monthly fee you get 
a 28.8 kbps wireless modem and Internet IP access from any 
area that is wired. The modem communicates with repeaters 
and other modems within a quarter mile radius. The network 
latency is pretty high, making the effective throughput more 
like 14.4 kbps, but it is still an effective solution for those who 
can't afford to be without email for even a few hours. 


FINAL WORD 

And so, on the seventh day — well, the sixth actually, since we 
arrived on a Monday and got home late on the Friday - we 
rested. Your Humble Managing Editor spent the weekend 
basically supine, very worn out, but very contented as well. 
We saw enough to propel us forward as a magazine, picking 
up lots of leads that should pan out into articles over the 
coming months (write and tell us what would particularly 
interest you!), and enough to feel that the Macintosh, too, is 
being propelled forward by the enthusiasm and ingenuity and 
dedication of its programmers. 

Here at the Editorial offices of MacTech Magazine, there 
seems to be a prevailing attitude that computers are for fun, 
and that part of that fun is programming. When tools make the 
Mac easy and fun to program, the power of the computer is 
put into the hands of the user, where it belongs. If the 
numbers of exhibitors and customers in Developer Central is 
any indication, the Mac, so far from being moribund, might be 
entering a Golden Age. 

See page 73 for the URLs connected with this article. 


Visual Programming Languages 
http://www.cs.orst.edu/~burnett/vpl.htm| 


Dynamic Languages for the Mac 
nttp://www.cambridge.apple.com/ 
other-langs/dynamic-languages.htm| 


CyberTheory, for Cyberspace Intellectuals 
nttp://www.treedonia.com/ctheory/ 


Visit MacTech Magazine’s Web site! 


nttp://www.mactech.com 
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By Bob Boonstra, Westford, Massachusetts 


MUTANT LIFE 

Time for a little nostalgia this month. Most of you probably 
remember John Conway’s exploration of cellular automata 
known as the game of Life. The game is played on a grid of 
square cells. A cell has one of two states — it can be occupied 
(“alive”) or empty (“dead”). Time proceeds in discrete 
increments, or generations, and the state of a cell at time N+1 
is determined by its state and that of its eight neighbors at 
time N. In the simplest variations of the game, a “birth” 
occurs in an empty cell if exactly three of its neighbors were 
alive in the previous generation. A “death” occurs in an 
occupied cell surrounded by four or more living cells, or by 
fewer than two living cells. 

This month, the challenge is to write code that will 
compute the state of a Life-like world some number of 
generations into the future. The prototype for the code you 
should write is: 
pascal long PropagateLife( 

BitMap cells, /* the boundaries and population of your automata */ 

long numGenerations, /* number of generations to propagate */ 

short birthRules, /* defines when cells become alive */ 

7 short deathRules /* defines when cells die */ 

Your automata live in a world defined by the rectangle 
cells.bounds (with top and left coordinates guaranteed 
to be 0). Their world is actually a torus instead of a rectangle: 
the cells.bounds.right-1 column of cells is adjacent to 
column 0, and the cells.bounds.bottom-1 row of cells is 
adjacent to row 0. The rules for birth and death are generalized 
from those in the first paragraph and defined by birthRules 
and deathRules. An empty cell with X occupied neighbors 
becomes alive in the next generation if the bit (birthRules 
& (1<<X)) is set. An occupied cell with Y occupied neighbors 


Here’s how it works: Each month we present a new 
programming challenge. First, write some code that solves the 
challenge. Second, optimize your code (a lot). Then, submit your solution to 
MacTech magazine. We choose a winner based on code correctness, speed, 
size, and elegance (in that order of importance) as well as the submission 
date. In the event of multiple equally desirable solutions, we'll choose one 
winner (with honorable mention, but no prize, given to the runner up). The 
prize for each month’s best solution is a $100 credit in the MacTech Mail 
Order Store and a limited-edition, “The Winner! MacTech Programmers 
Challenge” T-shirt (not available in stores anywhere). 

Unless stated otherwise in the problem statement, the following rules apply: 
All solutions must be in ANSI compatible C. Use only pure C code. We disqualify 
entries with any assembly in them (except for challenges specifically stating 
otherwise). You may call any Macintosh Toolbox routine (e.g., it doesn’t matter if 
you use NewPtr instead of malloc). We test entries with compiler options set to 
disable FPU use (for 680x0 code) and to enable all available speed optimizations. 
The compiler to be used and the target instruction set (680x0 or PowerPC) will be 
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dies in the next generation if the bit (deathRules & (1<<Y)) 
is set. Any other cell retains its previous state (occupied or 
empty) from one generation to the next. As an example, the 
version of the game described in the first paragraph would have 
birthRules=0x0008 and deathRules=0x01F3. 

The initial population of automata is pointed to by 
cells.baseAddr, one bit per cell, when PropagateLife is 
called. An occupied cell has the value 1, and an empty cell has 
the value 0. The cells BitMap is defined in the usual way, 
with row R found starting at *(cells.baseAddr +t 
R*cells.rowBytes). You are to use birthRules and 
deathRules to propagate this population ahead for 
numGenerations generations, stopping only in the event that 
the population of generation N is identical to that of the 
immediately preceeding generation. Your code must return the 
number of generations processed (which will be 
numGenerations unless a static population was reached). 
When you return, the memory pointed to by 
cells.baseAddr must contain the propagated population. 

You may allocate a reasonable amount of auxiliary storage if 
that is helpful, provided (as always) that you deallocate any 
memory before returning, as I will be calling your code many times. 

This month, we continue the language experiment that 
permits your solution to the Challenge to be coded in C, C++, 
or Pascal, using your choice among the MPW, Metrowerks, or 
Symantec compilers for these languages. The environment you 
choose must support linking your solution with test code 
written in C. Along with your solution, you should provide a 
project file or make file that will generate a stand-alone 
application that calls your solution from C test code. 

This will be a native PowerPC Challenge. 


propagating ... 


Now, Start 


stated in the problem. Limit your code to 60 characters per line; _ 
this helps with e-mail gateways and page layout. 

We publish the solution and winners for each month’s Programmer's 
Challenge two months later. All submissions must be received by the 10th 
day of the month printed on the front cover of this issue. 

You can get a head start on the challenge by reading the online version. 
We post it to the online services at the same time that we post source code. 
We make every effort to have it online no later than when the magazines are 
mailed, but we’re unable to guarantee that it will be online by any given date. 

Mark solutions “Attn: Programmer's Challenge Solution” and send it by 
e-mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us” section on page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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Two MONTHS AGO WINNER 


Congratulations to Ernst Munter (Kanata, Ontario) for 
submitting the fastest entry to the Intersecting Rectangles 
Challenge. Of the eighteen contestants who submitted entries, 
sixteen provided correct solutions. Recall that the Challenge was 
to provide code that would return a set of output rectangles 
containing all points inside in an odd number (or an even 
number, depending on an input parameter) of input rectangles. 

A number of solutions scanned the list of input rectangles 
and created a list of rectangles formed by the intersections, 
keeping track of whether the resulting subrectangles were inside 
an odd or an even number of input rectangles. Other solutions 
used a bitmap approach, calculating the exclusive OR of the 
input rectangles (for the odd parity case). The bitmap technique 
tended to suffer when the rectangles spanned a large x/y space. 

The winning solution combines these techniques in an 
interesting way. Ernst first scans the input rectangles to collect 
and sort the unique x and y vertex coordinates. He then forms a 
reduced-scale bitmap using these virtual pixels (dubbed “vixels”), 
applying the XOR technique to compute the odd or even parity 
intersections of the input rectangles. Finally, Ernst scans the 
“vixelMap” to form output rectangles of the appropriate parity. 
An innovative technique that was not only fast but also space- 
efficient compared with many of the other entries. 

The table below summarizes the results for entries that 
worked correctly. It shows the total time required for 60 test cases 
of up to 250 input rectangles per test case, the number of output 
rectangles produced, and the total code/data size of each entry. 
(The limit of 250 input rectangles resulted from the large memory 
requirements of some of the solutions.) Numbers in parentheses 
after a person’s name indicate that person’s cumulative point total 
for all previous Challenges, not including this one. 


Name time # of rects size 
Ernst Munter (112)... 2 teeters 105460 wo. 2264 
ACC Murphy ........ccccccee 998 voscacicescsis 440550 wees. 1210 
John Nevard (10)... Dy licectacttnesty. 98804 woo. 3092 
Miguel Cruz Picdo (7)......... DOB cpsthcnak 261562 sscsessricess 1328 
Xan Gregg (88) wee TF 1 astesasvinoe: LOGO 7S iwaseveostvaes 1252 
Cathy Saxton oo... G54 sevcesssansist 457508 oo... 1148 
David Cary wove 150 Uowvuaiciaee: S098 srcpscacinses 2205 
Elden Wood......iccecceeeee. 5824.0... 179) UU nccas 1012 
Bob Clark ...cccccccccccsecesseeee, 6016... 1789749 woe 1572 
Randy Boring .......ccccee O03 eciecerpsst 440550 wee. 2589 
PICK KIDOIS gocse cn tekanectcns, LA esto eee 1785710... 1218 
Tom Saxton (10)... T5200 crvieccaoiee: 98041 woe. 1264 
Richard Cann... ZNO S axtaseussions DOT 2A wesapceese: 3581 
PMS SGA agreencesa cas eecarthoncaees 54838... cee. 435049 woo 1125 
Rishi Khan ........cecceeee. TOO 20 xcsscaateies 2795136 eee 1288 
Michael White ...00...0... 938191... 239924 voce 1796 


Top 20 CONTESTANTS OF ALL TIME 
Here are the Top Contestants for the Programmer’s Challenges 
to date, including everyone who has accumulated more than 20 
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points. The numbers below include points awarded for this 
month’s entrants. 


Rank Name Points Rank Name Points 
1. [Name deleted] 176 11. ~~ Mallett, Jeff 44 
Z, Munter, Ernst 132. 12.  Kasparian, Raffi 42 
2: Gregg, Xan 92 13. Vineyard, Jeremy 42 
4, Larsson, Gustav 87 14.  Lengyel, Eric 40 
5. Karsh, Bill 80 15. Darrah, Dave 41 
6. Stenger, Allen 65 16. Brown, Jorg 30 
ie Riha, Stepan 51 17. Landry, Larry 29 
8. Cutts, Kevin 50 18. Elwertowski, Tom 24 
9. Goebel, James 49 19. Lee, Johnny 22 


KH 
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Nepsund, Ronald 47 20. Noll, Robert 22 
There are three ways to earn points: (1) scoring in the top 
5 of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win are: 


Ist place........ 20 points 
2nd place.......10 points 
3rd place ....... 7 points 
4th place........ 4 points 


DED TACO sist seacteyancnennenns 2 points 
PUGS DO: sccrcornainenis 2 points 
suggesting Challenge...2 points 


Xan Gregg earns two points this month for being the 
first to point out an error in the winning Find Again and Again 
solution by Gustav Larsson published in the February issue. 
The error occurs because the routines BMH_Search() and 
SimpleSearch() use signed declarations char * when they 
ought to use unsigned char *. As a result, processing is not 
correct in some cases when the textToSearch contains 
characters >= 0x80. There was confusion on this point in a 
number of the entries, and I did not penalize any of the 
solutions for making this error. 


Here is Ernst’s winning Intersecting Rectangles solution: 


INTERSECTRECTS.C 
Copyright 1996, Ernst Munter, Kanata, ON, Canada 


The Problem 





Given a bunch of overlapping rectangles, compute a set 

of rectangles which covers the area of either an odd or 

an even number of overlaps. The output rects should only 
use edges from the repertoire of edges contained in the 
input set of rects. 


General Strategy 





We create a virtual raster with a (variable) resolution, 
where each x or y coordinate value corresponds to an 
edge of at least one input rectangle. Depending on the 
number of input rects, and their coincidence of edges, 
this raster may be very small, or fairly large, but never 
larger than the screen it represents. 


We then paint rectangles into the raster, each raster 


point being represented by 1 bit, regardless how many 
pixels are within the corresponding edges on the real 
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screen. I call these bits “virtual pixels” or “vixels”. OxXOFFFFFFF, OxO/FFFFFF, Ox03FFFFFF, OxO1FFFFFF, 
OxOOFFFFFF, OxO0/FFFFF, Ox003FFFFF, OxOO1FFFFF, 











After all vixels are painted, the bit map is scanned OxOOOFFFFF, OxO0O07FFFF, Ox0003FFFF, Ox0001FFFF, 
to identify rectangular areas of set bits. OxOOOOFFFF, OxO0007FFF, Ox00003FFF, Ox00001FFF, 
OxO0000FFF, OxO00007FF, Ox000003FF, OxO000001FF, 
The vertical extent of each output rect is at least equal OxOO00000FF, Ox0000007F, 0x0000003F, Ox0000001F, 
to the distance between the two neighboring input edges. Ox0000000F, 0x00000007, 0x00000003, 0x00000001}; 
We then follow the slice down over as many slices as long rightMask[32] = 
possible to maximize the height of the rectangle. {0x80000000, OxC0000000, OxE0000000, OxF0000000, 
OxF8000000, OxFCO00000, OxFEO00000, OxFF000000, 

Memory Use OxFF800000, OxFFCO0000, OxFFEO0000, OxFFFO0000, 
names OxFFF80000, OxFFFCO000, OxFFFEOO00, OxFFFFQOOO, 
The maximum amount of memory allocated dynamically is OxFFFF8000, OxFFFFCO00, OxFFFFEO0O0, OxFFFFFOO0O, 
determined by the number of input rects. The actual OxFFFFF800, OxFFFFFCO0, OxFFFFFEOO, OxFFFFFFOO, 
amount will be less if some input rects share edge OxFFFFFF80, OxFFFFFFCO, OxFFFFFFEO, OxFFFFFFFO, 
coordinate values. OxFFFFFFF8, OxFFFFFFFC, OxFFFFFFFE, OxFFFFFFFF} ; 
Approximate size of the index heap: 
(16 * numRectsIn) bytes RectangleIntersections 

plus a few overhead bytes void RectangleIntersections ( 

const Rect inputRects[], 

Approximate combined size of the two vixel maps: const long numRectsIn, 
(numRectsIn * numRectsIn) bytes Rect outputRects[], 

plus a few overhead bytes, long *numRectsOut, 

minus gain from elimination of duplicate values const Boolean oddParity) | 
A double size vixel map is always allocated although long* xHeap; 
only the even parity case needs both. long*. yHeap; 


long* vixelMap; 
For example, total dynamic memory for 100 rectangles will 


be about 16K. 1000 rectangles might need 1MB, but on long* xIndex; 
any reasonable size screen, 1000 rectangles will share long* yIndex; 
a very large number of edges, and will have considerably long xIndexMax; 
less memory allocated. long ylIndexMax; 


long xHeapSize; 
long yHeapSize; 
Other assumptions (these are not checked) 


——— long i; 
There is at least one input rect. long mapWidth; 
long mapSize; 
All input rects are legal and not empty, that is: Rect* ORptr = outputRects; 
top<bottom, and left<right. 
i // First, we collect all X and Y coordinate values of 
// all input rectangles in a heap (priority queue), which 
#include <stdlib.h> // is then sorted into an index without duplicates for each 
#include <stdio.h> // dimension, using a modified form of Heapsort. 
#include <string.h> 
#tdefine MAXLONG Ox7fffffff *numRectsOut=0; 
if (0==(yHeap=(long*)malloc((numRectsInt3) *sizeof (long) *4) )) 
void RectangleIntersections ( return; 
const Rect inputRects[], xHeap=yHeapt (numRectsInt3) *2; 
const long numRectsIn, 
Rect outputRects[], *xHeap=* yHeap=MAXLONG; 
long ‘*numRectsOut, xHeapSize=yHeapSize=l ; 


const Boolean oddParity) ; 
for (i=O:i<numRectsIn;itt) { 


// Local function prototypes: Insert (yHeap, yHeapSize, IRT) ; yHeapSizet+; 
void PaintOdd(long* vm,long H,long L,long R,long mapWidth) ; Insert (yHeap, yHeapSize, IRB) ; yHeapSizett; 
void PaintEven(long* vm,long H,long L,long R,long mapWidth) ; Insert (xHeap,xHeapSize, IRL); xHeapSizett; 
void PackMap(long* vm,long mapSize) ; Insert (xHeap, xHeapSize, IRR) ; xHeapSizet+; 
void Insert(long* h,long size,long x); } 
long* Sort(long* h,long size); 
long GetIndex(long size,long* index,long z); xIndex=Sort (xHeap, xHeapSize) ; 
xIndexMax=xHeapSize- (xIndex-xHeap) ; 

//Some shorthand macros: yiIndex=Sort (yHeap, yHeapSize) ; 
#define IRT (inputRects [i] .top) yIndexMax=yHeapSize- (yIndex-yHeap) ; 
#define IRL (inputRects[i].left) 
#define IRB (inputRects [i] .bottom) //note: IndexMax indexes to the last entry index[indexMax] 
#tdefine IRR (inputRects [i] .right) // in each index list. index[0] and index[indexMax] 

// are the edges of the enclosing rectangle. 
#define ORT (ORptr->top) 
define ORL (ORptr->left) // Each block of real pixels that is defined by adjacent 
#define ORB (ORptr->bottom) // Xand Y edges (from any input rectangle) is considered 
#tdefine ORR (ORptr->right) // as a single virtual pixel (“vixel”). The map of these 

// vixels will then be populated by the input rectangles. 
/* Masks needed to process the edges of vixel blocks // Each vixel is represented by a bit in vixelMap. 

which are not necessarily aligned with bitmap words. 

*/ // We get memory for the vixel map and clear it to 0. 
long leftMask[32] = // Vixels are stored as bitmaps in 32-bit words. 


{OxXFFFFFFFF, Ox/FFFFFFF, Ox3FFFFFFF, OxlFFFFFFF, 
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// to pack it into the same format as the odd parity 
// vixelMap. 


Mac Source Sie CD- ROM Le Vintdbactiyy Rechlaptcteetvap mnie 


: : ae // Now the vixelMap (the bitmap of all vixels, that is 
g fe a // areas of the screen), is set to 1 for every vixel 
. ra // meeting the criteria of either odd or even parity. 
Ir ( ni C = i aE // We scan the vixel map to find contiguous regions of 
seems Ss // non-zero vixels in order to generate the output 
a wa en gees // rectangles. For each row, we successively look for 


// blocks of set vixels. This will define one output rect. 
// The X/Y index arrays serve to convert the vixel 


: | eke // coordinates back to the real pixel coordinates which 
" 5 : e i el fe // define the output rectangles. 
a ons { long word,bit,bb,c,u,L,B; 


or % long* vm=vixelMap; 
"t' s wonderful. It's saved | me probably 20 hours of time ial = id Indextlax 4) 


ie (1 
_ in just the last week. It is well worth adding to your bit=0; 
collection, definitely one of the most useful CDs in Any. e=0; 
collection. rr for (word=0;word<mapWidth;wordtt) { 
. u=vm [word] ;c=0; 


: Pajeed ovis if (u) | 
a _— eS <<a long* vmBelow=vmtword+mapWidth; 
Over 650 megabytes of high-quality and up-to-date Mac-only source code from oa ? 
~ hundreds of programmers. If you're looking for great source code examples, this is the — do { 
- CD-ROM for you. All ofthe source code examplesare new and updated in this release! while (uO) {bb+t;u<s—15) 
Apprentice souree is mostly C, C++, and Pascal, using CodeWarrior, Symantec, and — it Ce 
L=bb ; 


_- MPW. Includes examples of applications, games, code resources, control panels, ie ORi=s tndéx har | 


oO 
\ 


.. “system extensions, plug-in modules, hundreds of snippets, and much more! fooies | 
- $35. Upgrade from any previous Apprentice release for only. ai Be long* vmx=vmBelow; 
Shipping included for U.S. and Canadian orders. Add $5.for shipping outside the U.S. and Canada. heal pe een © eee 
_ Visa, MasterCard, American Express, and Discover gladly accepted — //Default: the rectangle is 1 vixel high. 
Celestin Company, Inc., 1152 Hastings Avenue, Port Townsend, WA 98368 //We try to extend rectangle down as far as eee 7 
800 835 5514 » 360 385 3767 © 360 385 3586 fax ale eee | ed) 


Bt++;*vmx &= mask;vmxt=mapWidth; 





Internet: celestin@celestin.com ¢ http://www.celestin.com/ 


ORB=yIndex[B] ; 

ORR=xIndex|[bittbb] ; 

ORT=yIndex [i] ; 

ORptrtt; 

C=): 
} 
if (0==(u=(~u) & rightMask[31-bb])) break; 
mapWidth=(32+xIndexMax) >> 5; } while (bb<32) ; 
mapSize=mapWidth* (yIndexMax+1) ; it te) 4 
if (0==(vixelMap= long* vmx=vmBelow; 

(long*)malloc(2*mapSize*sizeof(long)))) return; tong mask=~leftMask[L] ; 

if boda vary memset (vixelMap,0,mapSize*sizeof(long)); B=itl; 


else memset (vixelMap,0,2*mapSize*sizeof(long)) ; while (-1==(mask | *vmx)) [ 
Bt++;*vmx &= mask;vmxt=mapWidth; 


| 
J 


// The vixel map is initially organized as either 1 word 
// per 32 vixels (odd parity) or 2 words (even parity). 


// With odd parity, it is only necessary to XOR the vixels 








// of all input rects (PaintOdd). ORB=y Index [B] ; 
ORR=xIndex [bitt+32]; 
// With even parity, we also need to OR all vixels. This ORT-yIndex [i] ; 
// is done in the alternate words of vixelMap (PaintEven); — ORptrtt; 
// hence the vixelMap is stretched with even parity. 22 
// Accumulate the enclosed vixels of each input rect: . bitt=32; 
for (i=0;i<numRectsIn;itt) { vmt=mapWidth; 
long 1T,L,B,R,x,y; | 
Long” ai 
T=Get Index (yIndexMax, yIndex, IRT) ; 
TCer index (aindexWex <index, IRL) free (yHeap) ; //free allocated memory 
B=Get Index (yIndexMax, yIndex, IRB) ; free(vixelMap) ; 
R=Get Index (xIndexMax,xIndex, IRR) ; “numRectsOut=ORptr-outputRects; 
if (oddParity) { 
vm=vixelMaptmapWidth*Tt+(L>>5) ; 
PaintOdd(vm,B-T,L,R-1,mapWidth) ; TMM MATT 
} else { // Auxiliary functions called by RectangleIntersections: // 
vm=vixelMapt2* (mapWidth*T+(L>>5)); TMM 
PaintEven(vm,B-T,L,R-1,mapWidth) ; 
Insert 
/* Insert grows a heap, that is a partially sorted balanced 
binary tree, where each node’s children must be less or 
// For even parity, XOR all pairs of words in the vixelMap equal, but not in any particular order. 
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Each value x is inserted by appending it as the last node 
and then sifting it up (exchanging father and child ~ 
nodes) until the heap property is restored. 
/ 
void Insert(long* h,long size,long x) { 
long 444424 
i=6izes 
do { 
j=i>>1; 
if (x<=(z=hlj])) break; 
hilij=z: 
cle 
} while(1); 
h[il=x; 





Sort 
/* The heap keeps the largest value at the root, at h[1]. 
We sort as follows: each root value is removed and put 
at the end of the array; then the last item in the heap 
is put into the root and sifted down until the heap 
property is restored. 
When we are done, the array is sorted. 
As we go along, we recognize duplicate values and remove 
them but do not put them back. The result is that the 
start of the sorted list may be further up in the array. 
/ 
long* Sort(long* h,long size) { 
lone 42,1543 
long* b=htsizertl; 
*b=MAXLONG ; 
if (size>1) do { 
size=?% 
a a 
j=2; 
if (*b != (g=h[1])) *(-=b) = a: 
if (size<=1) break; 
x=h [size]; 
h[size]=-MAXLONG; 
while (j<size) { 
long h0=h[j],hl=h[1+j]; 
if (hO<h1) (j++; h0=h1;)} 
if (x>=h0) break; 
h[i]=h0; 
1=]5 
JJ 





} 

h[il=x;: 
} while(l1); 
return b; 





GetIndex 
/* GetIndex uses a binary search to locate a particular 
entry and returns its index. 
“/ 
long GetIndex(long r,long* index,long z) { 
long 1=0,m=r7?1,¥; 
do { 
if (z>(y=index[m])) l=m+1; 
else if (z<y) ean; 
else return m; 
m=(1+r)>713 
} while (1l<r); 
return fr; 





PaintOdd 
/* The PaintOdd and PaintEven routines paint rectangles 
into the vixel map. 
PaintOdd only XORs a single bit map with a rectangle. 
PaintEven also ORs a second bit map with the same 
rectangle. The 2 bit maps are word interleaved. 
It is hoped that this reduces cache misses by keeping 
to one area of memory for each row of a rectangle. 
* 
/ 


void PaintOdd(long* vm,long H,long L,long R,long mapWidth) { 


long LM=leftMask[L & 31]; 
long RM=rightMask[R & 31]; 
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ng numMid=(R>>5)-(L>>5)-1; 
g x,y,pad=mapWidth-numMid-2; 


if (numMid<0) {LM&=RM;RM=0; } 


for (y=O;y<H;syt+) { 
*vm “= LM; vmtt; 
for (x=0;x<numMid:xtt+) { 
*yvm “= OxFFFFFFFF; vmtt; 


if (RM) { 

*vm ‘= RM; vmtt; 
} 
vmt=pad ; 





PaintEven 
void PaintEven (long* vm,long H,long L,long R,long mapWidth) 


long LM=leftMask[L & 31]; 

long RM=rightMask[R & 31]; 

long numMid=(R>>5)-(L>>5)-1; 

long x,y,pad=(mapWidth-numMid-2)<<1; 


if (numMid<0) {LM&=RM;RM=0; } 


for (y=0;y<H;sytt) [{ 
*ym “= LM; vmtt; 
*vm |= LM; vmtt; 
for (x=0;x<numMid;xt++) { 
*yvm S= OxFFFFFFFF; vmtt; 
*yvm |= OxFFFFFFFF; vmtt+; 


if (RM) | 
*vm “= RM; vmtt; 
*vm |= RM; vmtt; 
} 
vmt=pad ; 





PackMap 
/* PackMap reduces the two interleaved bit maps used for 
the even parity case, into a single bit map. Each 
pair of words, of the entire bitmap, is XORed together 
regardless of rectangle boundaries. 
” 
void PackMap(long* vm,long mapSize) { 
long* vmE=vm; 
long* endOfMap=vmtmapSize; 
while (vm<endOfMap) 
*yvmt+ = *vmE * vmE[1]; 
ynEtT=2 3 
} 


| 
J 








Visit MacTech Magazine’s Web site! 
http://www.mactech.com 


Internet Type Foundry Index 


http://users.aol.com/typeindex/ 
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Spare your fingers and find the full list online at: 
http://www.mactech.com/URLs.html 


This month we have lots of updates. I have tried to verify 
every URL in the list. However, sometimes things change 
between the time I write this column and when the magazine 
gets published. Be sure to let me know if you find any 
problems or changes. Besides all the updates, there are the 
usual new sites and commentary. 


LATEST UPDATES 


Internet Related 

Apple-Internet mailing lists http://www.solutions.apple.com/apple-internet) 

ClayBasket = sits http://www. hotwired.com/staff/userland/yabbadabba/ 

Internet Config — ftp: /iftp. share. .com/pub/internet- configuration/index. html 

a7 en CoCr comer sl 

Natural Intelligence Roaster ae coe ee ee eee 

veenisg — eee ako WWW) eee eneeE EeenTe 
~ Mailing List ~ http://www.starnine.com/webstar/mailinglist.html 

Registry http://brad.net/macwww/ 


Extending MacHTTP _http://www.comvista.com/net/www/lessons/START_HERE.htm| 





OnBase Technology http://www.onbase.com/ 

Te a i in eon le 
Portable Net. Graphics —_http://www.boutell.com/boutell/png/ —— 
ShockWave =—S—si*http//ww.macromedia.com/Tools/Shockwave/ 
URLManager stp //www.xs4all.nl/~alco/urlm/ —— 


WWW, Jon W. Mac WWW Development Guide 
http://www.comvista.com/net/www/WWWDirectory.htm| 


New Technologies _ 


ace Mina 
see also http://thelorax.starnine.com/aoce/aoce.html 
a 
see also http://legend.gwydion.cs.cmu.edu/dylan 
Mindy ftp://ftp.bdt.com//home/beard/index.htm| 


OpenTransport/TCP = ~—sgopher://seeding.apple.com:70/11ftp:ess:public: 
_seealso  —_—__ftp://seeding.apple.com/ess/public/mactcp/ 
PowerPC News http: ‘//apt.usa. globalnews. com/powerpc/ppchome. htm 


Other ie Sete Resources 


Carl de Cordova — 
http://atlantis.austin. =p comiprope tee eu dev.pointers.htm| 


MOPS ftp://taygeta.com/pub/Forth/Mops/ 

Yerk ftp://taygeta.com/pub/Forth/Yerk/ 
eo ae ine one encmetar 
MacTech tpn con abate ol sided boi iL Lo 
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Vendors, Products and Miscellaneous) 
ACIUS4D tp s/www.acius.com 
APS Technologies _ https! www, oats) com/ | 


Iconix http: liwwow.' iconixsw. on 

Language Systems (Fortner Research) —_—http://www.langsys.com/langsys 
MacHax Group _ http://www.hax.com/hax.html _ 
MacMagazine ~ http://www.rust.net/~kepler/MacMagazine) 
ie ade 
non eeu 
MIND(formerly MacDNS) —_http://www.scriptweb.com/at/MIND/mind_home.html — 


Nisus http://www.nisus-soft.com/~nisus 

PlayitagainMac =———_—sinttp://www.pht.com/mac_menu.html 
Pictorius (Prograph) —_tttp://www.pictorius.com/ 

Time Tracker ~ http://aloha.net/~mauisw 


UserLand http://www.hotwired.com/Staff/userland/ 
__seealso  __ ftp//gaea.scriptweb.com/pub/trontie) 
WASTE http://cirrus.sprl.umich.edu:80/waste/. 


Internet 

At MacWorld, several vendors were showing bookmark 
management software. Besides WebArranger and CyberFinder, 
which have been mentioned before, OnBase Technology had 
DragNet. [See also Jon Wiederspan’s discussion, on page 57 of 
this issue. - man] Nisus Software was showing MailKeeper, a 
program for managing your e-mail as well as URLs. On the 
shareware front, there is URL Manager and BookMark Manager. 
It seems to me that BookMark/URL management software is 
becoming the next PIM category. There are many of them out 
there, each with a slightly different angle, and everyone has his 
own favorite. We will probably see a shake-out of the 


commercial versions in a few years, as has happened with PIMs. 
OnBase Technology http://www.onbase.com/ 

URL Manager http://www.xs4all.nl/~alco/urlm/ 

BookMark Manager http://www.walrus.com/~noyo/ 


If you have not tried ShockWave from MacroMedia, you need 
to check it out. As I write this, they are only to version d17, but 
by the time you read this, it should be more stable. ShockWave 
allows Director’s animations and programs to run in the Netscape 


browser. It looks to be a great multimedia tool for the Internet. 
ShockWave http://www.macromedia.com/Tools/Shockwave/ 


Macintosh 

Here is a site with lots of information for Macintosh Web 
developers. It contains a comprehensive list of sites useful to 
developers at all levels, including beginners. Also, if you are 
thinking of expanding the capabilities of your site, check out 


some of his links to other Internet services that you can provide. 
Carl de Cordova 
http://atlantis.austin.apple.com/people.pages/carldec/web.dev.pointers.html 
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If you do not follow the alt.sources.mac newsgroup, you may 
not know that the entire archive is available on the web. This is a 
great source for those learning to program as well as experienced 
programmers who need some snippets to get something done. A 


great resource for anyone who is programming. 
Alt.Sources.Mac Archive _ http://www.AmbrosiaSW.com/alt.sources.mac/ 


I know it has been a while since I last mentioned Jon 
Pugh’s page, but it bears mentioning again. Jon is constantly 
adding information, particularly about AppleScript. If you 


create or use AppleScripts, you should keep up on this page. 
Jon Pugh (AppleScript) 
http://www.infoworkshop.com/~jonpugh/Default.html 


Neat non-Macintosh site of the Month 

Have you ever wanted to be able to garden from your 
desk? You now can, through the Web. A group at the 
University of Southern California have created a robotic garden, 
where members (who join for free) can plant, water, and watch 
seedlings. Even if you do not join, check it out for an 
interesting experiment in performance art, robotic technology, 


and remote control. 


Tele-Garden http://www.usc.edu/dept/garden/ 








Here at MacTech Magazine, we rely heavily on outside writers for 
most of the material that appears in our pages. If readers did not 
participate in the magazine, sending us their ideas and taking the 
time to write articles, there would be no MacTech. We like to 
think of MacTech as an ongoing dialogue amongst members of the 
Mac programming world: we facilitate the discussion, but it’s the 
readers who carry it on, by responding to what they read and to 
their own programming experiences and interests, in writing. 
Sometimes we know that we need something specific covered, 
and we approach someone to write an article on that subject; and 
we do write a few columns in-house each month. But it is reader 
contributions, in the form of letters, tips, and especially articles, 
that give the magazine its relevance, its character, and its appeal. 

So MacTech Magazine is not a staff of writers sending a 
constant stream of one-way messages outwards; it’s a living, 
evolving network of readers conversing with one another, 
educating one another, sharing their knowledge, their experience, 
their interest, their trials and tribulations and joys and successes in 
the constantly unfolding story of programming the Macintosh. 
MacTech Magazine doesn’t just happen: it’s what the community 
makes it. If we carry reports of future trends and technologies, if 
we teach useful methods, if we review new books and tools, if we 
provoke thought, provide help, ride the wave of current interests 
and concerns, it is only because we reflect the thoughts of our 
readers, who speak through our pages. 

You are invited to involve yourself in this exciting conversation 
amongst readers. You may be working at the cutting edge of 
programming technology, as part of a heavily funded professional 
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Here is a site devoted to “devices for hurling weird objects 
through the air’. This includes your traditional trebuche, which 
are like catapults, as well as things like the “spud gun”, which 
shoots (you guessed it) potatoes, using aerosols. Some of this 
stuff (okay, most of this stuff) can be dangerous. Neither I nor 
MacTech are responsible if you read this and hurt yourself; but 


have fun reading it. 
Backyard Ballistics —http://www2.csn.net/~bsimon/backyard.html 


Well, that is it for this month. As always, if you find 
something interesting, or have updates, send them to 
URLs@MacTech.com. 


Thanks this month to Alco Blom, Geoffrey Clapp, Carl de 
Cordova, John Daub, Jay Farrell, Keithen Hayenga, Celso 
Maiolo, Dave Nebinger, Jon Pugh, Chris Younger, and many 
others for their contributions for their suggestions and pointers 


GeT YOUR NAME “IN LIGHTS” 


to new and old sites. 





developer effort, you may be a lone hobbyist wrestling to create 
shareware for the sheer love of it. You may have been programming 
the Mac since its inception; you may have just switched over from 
Windows or Unix. You may work in C or C++ or Pascal or 
AppleScript, from scratch or in a framework. You may write big 
apps, small apps, custom solutions, extensions, code segments, for 
profit, for fun, for education, to solve one problem once. No matter 
who you are, no matter what your credentials may be, if you have a 
tale to tell, a trick to share, a technique to teach, we want you to 
consider joining the family of those who write for MacTech. 

Don’t just wait for a topic to be covered in MacTech! Don't 
just wish some technique would be explained better!. Take 
responsibility! Write us an article yourself! 

To write for MacTech, just send for our Writer's Kit. It’s a 
Microsoft Word file containing the Styles you need to use, and 
giving lots of helpful advice and information, including all the legal 
stuff. You can let us know what you're writing about, if you want 
suggestions or feedback; this is helpful to us, because it lets us 
plan for the future. Or if you want to, you can just write the article 
and spring it on us when it’s done. If we publish your article, 
you'll be paid for it! 

Write to me, Matt Neuburg, at managing_ed@mactech.com (or 
one of the other editorial addresses listed on page 2 of the 
magazine). Ask me for a Writer's Kit! Send me an article! Get 
published! Make money! See your name in print up there 
alongside the famous denizens of MacTech! For Mac) er 
And, most important, take the future of , Z : 
MacTech Magazine into your own hands! 
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NEWSBITS 





By John Kawakami, Editorial Assistant 


APPLE MAy HAVE FIGURED OuT How To USE 

THE INTERNET AFTER ALL 
Apple’s QuickDraw 3D team is working to have QD3D adopted 
as the foundation for the next version of VRML, the Virtual 
Reality Modeling Language, the dominant VR standard on the 
Internet. The project and proposal, titled Out of This World, are 
viewable at the URL below. In order to participate in the 
development of VRML, Apple must follow the the rules set forth 
by the VRML Architecture Group, which are modeled on the 
Internet RFC process, an “open” process. That means that all 
competing proposals are publicly available on the Internet, and 
each proposal must be a functioning package. To compete 
effectively, not only must Apple show that their API is the best, 
but they must have proof-of-concept demos, free source code, 
free SDKs, and they must also provide some access to the 
engineering team. 

What’s most encouraging about this effort to evangelize 
QD3D, we feel, is that it is like the evangelism for Internet 
Config, which is now a de facto standard despite the fact that it 
was not invented by Apple. (See MacTech 11.4 [April 1995] 
24-41.) Internet Config’s open development stands in stark 
contrast to that of technologies like AOCE and QuickDraw GX, 
which were developed “behind closed doors”. 

Evangelism for QD3D is also in line with Apple’s latest 
efforts to make more developer resources available for free on 
the Internet, and may signal a change in the way they promote 
new technologies. 


Out of This World / QuickDraw 3D: 
http://product.info.apple.com/qd3d/VRML20/Out_Of_This_World.HTML 

VRML Request for Proposals: _http://vag.vrml.org/rfp.htm| 

Internet Config: ftp://ftp.share.com/pub/internet-configuration/ 


THE USENET MACINTOSH PROGRAMMING AWARDS 


Once again, it’s time for the Usenet Macintosh Programming 
Awards. Matthew Xavier Mora has organized this annual contest 
to honor people and products in the Macintosh Programming 
world. Awards are given for Outstanding Programming for a 
Commercial Product, a Shareware Product, a Freeware Product, 
and a utility. There’s also a SmartFriend award for the most 
helpful comp.sys.mac.programmer.* net citizen, and an award for 
Outstanding Support of the Macintosh programming community. 

Nominations are being accepted through March, voting will 
take place via email during April, and the awards should be 
presented at the Netters’ Dinner at WWDC ’96 in May. For 
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details, keep reading comp.sys.mac.programmer.info and the 
other groups. (What? You don’t already?) If anything should 
change, the details will be disseminated via these newsgroups. 

Since this contest is intended for programmers to honor 
their peers, one must answer this question to nominate a 
programmer: “What is the recommended sleep value for 
WaitNextEvent for a foreground Application?” 


http://www.best.com/~mxmora/UMPA.html 


LPA ANNOUNCES Fuzzy Loic TooLs 

Logic Programming Associates’ FLINT makes fuzzy logic 
technology available within a sophisticated programming 
environment. Fuzzy logic permits the use of imprecise and vague 
information, knowledge and concepts to be used in an exact 
mathematical manner. Words such as “fast”, “slow”, “very hot”, 
“slightly cold”, “not very hot” can be used to enhance traditional 
rule-base or expert systems. Qualitative and imprecise reasoning 
statements can be incorporated within these rule-bases to produce 
simpler, more intuitive and better behaved models. According to 
Lotfi Zadeh, the father of fuzzy logic, the linguistic, or “fuzzy”, 
description of a system is much more effective than a more 
specific, numerical or mathematical description. FLINT supports: 


e standard and user-defined membership functions 

e linear and curved membership lines 

e automatic propagation of fuzzy values 

e range of and/or/not combinators 

e configurable linguistic hedges 

e standard and user-defined defuzzification algorithms 


The product is available immediately worldwide for 
Windows, Macintosh and MS-DOS, and costs US$995. This 
includes the cost of a full-featured LPA Prolog compiler and 
programming development environment, and features two well- 
documented classical examples: a fuzzy controller and a project 
risk analyser. 

FLINT is also available as a versatile programming toolkit 
for LPA Prolog or as an extension to LPA’s popular expert 
system toolkit, Flex. | 


Logic Programming Associates, US Toll Free: 1-800-949- 
7507 Tel: +44 181 871 2016 Fax: +44 181 874 0449 

|lpa@cix.compulink.co.uk 

http://www.|pa.co.uk 
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For information about fuzzy logic, see 
http://www.cs.tamu.edu/research/CFL/ 


QC FOR THE POWERMAC 


Onyx Technology today announced a free update to its popular 
QC stress testing tool for the Macintosh. Version 1.2 is the long 
awaited PowerPC native version of QC; previous versions ran 
emulated on PowerMacs. New optimizations made in testing 
code together with the native PowerPC code have resulted in 
performance improvements ranging from 100% to 500%. 

The update also includes support for the powerful “Block 
Bounds Checking” and “Invalidate Free Memory” options on 
systems with Apple’s Modern Memory setting turned on. 
Previous versions of these tests were incompatible with Modern 
Memory and automatically disabled. 

Updates are available at the Onyx ftp site. 

QC is a system extension that allows programmers and test 
engineers to quickly isolate problems in application software 
and code resources that would otherwise randomly crash or 
hang various Macintosh configurations. These tests can be 
performed by non-technical personnel with little or no 
knowledge of Macintosh programming. Software engineers can 
take advantage of a custom API to achieve pinpoint control 
from directly within their code. QC gives developers and 
Quality Control personnel an extensive tool for stress testing 
their application software before it’s shipped. 

[OC spots many bugs that extensions like Even Better Bus 
Error and its cousins try to catch. In response, some tool writers 
have stopped updating their extensions because their tools are 
redundant. — jtk | 


onyxtech@aol.com 
http://www.std.com/onyxtech 
ftp://ftp.std.com/vendors/onyxtech/QC/ 


TELESCRIPT AGENTS CAN HANG OUT ON THE WEB 
General Magic, Inc., announced the availability of a free pre- 
release version of its Telescript Active Web Tools, a tool kit for 
developing active, personalized services for the World Wide 
Web using agent technology. General Magic’s pre-release 
version of the Active Web Tools is expected to be followed by 
updated releases through the year. 

The Active Web Tools feature a set of software 
development tools based on General Magic’s Telescript 
technology, an extensible, object-oriented remote programming 
language for creating active, agent-based network services. 

“The Web today is a passive entity — it connects you to lots 
of information, but the burden is on users to ‘surf to find what 
they’re looking for,” said Marc Porat, chairman and chief 
executive officer of General Magic. “The Telescript Active Web 
Tools are designed to enable developers to turn the Web into an 
active entity where users can delegate agents to watch, find, and 
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POSITIONS WANTED 
Available Immediately 1-800-736-3577 


Expert 4D Programmers 
Less than 50¢ per hour: 


More than 1,000 hours of development went a 
AD Toolkit 2.0. With a one time price of $399. 
it’s like hiring a crack team of 4D See : 
less than 50¢ per hour. Call 1-800-736-357/ to 


order your copy, OF tO receive a free demo. 


4DTOOLKIET" 


OPtions Computer Consulting 
228 Bleecker Street #19 

New York, NY 10014 

TEL: 212-645-3577 

FAX: 212-633-0336 


* upgrade pricing available 





orchestrate tasks on their behalf - even while the user is off-line.” 

General Magic’s presentation at Demo 796, an industry 
conference, included a demonstration of active, personalized 
services created with Active Web Tools. The demonstration 
also showed two-way interoperability between Telescript 
technology and Sun’s Java, illustrating the complementary 
nature of the two technologies. The Telescript Active Web 
Tools offer support for industry standards. They may be used 
with most web servers supporting the Common Gateway 
Interface (CGI). A web browser supporting HyperText Transfer 
Protocol (HTTP) can access Telescript agents running on a web 
site — no special client software is required. The Active Web 
Tools also enable agents to programmatically access and 
process content on remote web sites using HTTP. 


http://www.genmagic.com/awt 


More MULTIPROCESSING FROM TOTAL IMPACT 


Total Impact announced the Total PowerSMP and Total 
FreedomSMP, the fastest PCI multiprocessor application 
accelerator solution available for Apple’s Power Macintosh PCI 
computer systems. The Total PowerSMP system is equipped 
with 1, 2 or 4 PowerPC 604 microprocessors operating at clock 
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Bug Tracking the Macintosh Way 


TestTrack automates and simplifies tracking your bugs so you 
can concentrate on fixing them. Easy to set up, easy to use, 
and quick too! 


%& Track bugs, change requests, testers, 
configurations, and more 


% Produce concise reports 

% Automatically route bugs to team members 
% Minimum setup time 

% Multiple users, full security 


For more information, call or send e-mail to seapine@one.net 


Seapine 
e soltware 


Seapine Software, Inc. 
1066 Seapine Court 
Maineville, OH 45039 
513.683.6456 








speeds of 100, 120, 133 and 150MHz. The board also features 
512K of secondary cache and up to 1 gigabyte of user 
upgradable memory. 

The Total PowerSMP board is controlled by Total 
FreedomSMP’s symmetric multiprocessing software libraries. 
Total FreedomSMP’s libraries interface directly with Apple’s 
Operating System ToolBox and allow application software to be 
launched on the Total PowerSMP accelerator the same way that 
they're launched within the Power Macintosh itself. 

Because the Total PowerSMP system does not have an 
operating system running directly on any of its microprocessors, 
any application accessing the board has the full attention of all 
available PowerPC 604’s on the board. 

Total FreedomSMP will also ship with built-in library 
extensions that will work with Daystar Digital’s Genesis MP 
software (see MacTech 12.3 [March 1996] 46-54). These library 
extensions will give users of applications that have been 
written to take advantage of the Genesis MP system the ability 
to access the Total PowerSMP accelerator boards without any 
software modification. 


Total Impact, (805) 987-8704 http://www.totalimpact.com 
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HEIDI ROIZEN JOINS APPLE 


As everyone knows now, Apple has gone through major 
personnel changes. Dr. Gilbert Amelio is not only the new 
CEO, but is also the Chairman of the Board. Dr. Amelio’s 
success as a turnaround artist is well documented; he turned 
into profitable operations both a money losing division at 
Rockwell and an unprofitable National Semiconductor. 

Most significant to developers was the addition of Heidi 
Roizen, founder of T/Maker, as Vice President of Developer 
Relations in late January. For more details, see this month’s 
“Crabb’s Apple” column. 


Apple Press Releases 
http://support.info.apple.com/aboutapple/pr.htm| 


BE THERE Now 
Wonder what some Macintosh developers have been doing 
lately? You might want to check out comp.sys.be, the Be 
newsgroup. You'll watch in amazement as people talk about 
command shells and environment variables. The Be is so 
“programmer friendly” that it smells like Unix. Yikes! 


news:comp.sys.be 


APPLE SUPPORTS LINUX, MKLINUX Tur Is... 


If, while reading the following newsbit, some of the names are 
unfamiliar, you should refer to the section below titled, “You can’t 
tell the players without a card...”, and also check out the URLs. 

Apple Computer, Inc., announced on February 5 that it is 
supporting a project with the Open Software Foundation (OSF) 
to port Linux, a freely distributed version of UNIX, to a variety 
of Power Macintosh products. This version of Linux operates on 
the OSF Mach microkernel, which will be running natively on 
the PowerPC microprocessor. The announcement was made at 
the Conference on Freely Redistributable Software held in 
Cambridge. A demo of an early prototype was shown as part 
of the announcement. 

“This is part of Apple’s overall effort to embrace more open 
industry standards, particularly those popular in the Internet 
community,” said Ike Nassi, vice president of Apple system 
software technologies. “This software will be particularly 
popular with Mac users in higher education as well as the 
scientific research communities who have asked for our support 
of Linux.” 

With Linux, a student or researcher will have an extremely 
low-cost, yet high-performance PowerPC-based UNIX system 
for personal use. Advanced research that requires UNIX 
applications will now be possible on an engineer’s personal 
Macintosh. [Advanced research into networked Marathon will 
be possible too. Academics also prefer the superior document 
editing tools available on the Macintosh. — jk | 
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Apple is supporting this one specific project with OSF, 
nicknamed MkLinux, which is a microkernel-based operating 
system that is 100% compatible with the original monolithic 
Linux, since it is based upon almost entirely unmodified Linux 
code. Because it works with the OSF Mach3 microkernel, it is 
trivial to port to any platforms supported by the OSF Mach3 
microkernel. The Linux sources now include the Mach interface 
as a new machine type, but the same sources can also be used 
to build the original monolithic Linux. 

By using the OSF Mach3 microkernel, the resulting Linux 
system can also take advantage of new technologies, such as 
SMP, MMP, and hard real-time support. 

The porting group reports, on their web page, that porting 
from Intel to the PowerMac and getting to boot to multiuser 
took approximately three engineer-weeks, harnessing some of 
the work done on the native port of Linux to the PowerPC. 


Linux for the Power Macintosh (Apple’s Site about their 
efforts): http://www.mklinux.apple.com/ 

Linux on the OSF Microkernel (as opposed to the vanilla 
monolithic Linux): http://www.gr.osf.org/mklinux/ 

Linux for the PowerPC (porting Linux to the PowerPC): 
htto://www.|linuxppc.org/ 

The OpenMac Project (porting Linux and NetBSD to the 
Macintosh): http://puma.bevd.blacksburg.va.us/openmac/ 

NetBSD (a version of BSD Unix; Linux is based heavily on 
BSD Unix, not on System V): http://www.netbsd.org/index.htm| 


You can’t tell the players without a card... 

In typical Unix fashion, the effort to port Linux, the 
popular free operating system, over to the Power Macintosh, 
the most popular PowerPC platform, has fragmented into 
several loosely affiliated development threads. If this 
continues, there will be one Unix variant per Unix progammer! 
In the near future, these variants will likely reunite into a single 
system. What follows are descriptions of various Unix 
distributions in rough chronological order. 

AT&T — used to own Unix, and developed the System V 
Unix which is popular with businesses. 

BSD — Berkeley Standard Distribution, a variant of Unix 
which departed from AT&T’s Unix. Popular with universities 
because it was almost free and comes with sources. The free 
version is named NetBSD. 

Mach 3.0 — a microkernel developed at Carnegie Mellon. 
Variants have been developed at other sites, including the OSF. 

Tenon Intersystems, MachTEN — a commercial BSD variant 
which runs with Macintosh System 7. It’s been around a long 
time and is very stable. It also uses the Mach kernel. 

A/UX — remember this? 

OSF — the Open Software Foundation, which invents large, 
complex standards. They also have their own version of Mach 3. 

OSF Mach3 Microkernel — a microkernel upon which an 
system can be executed. This contrasts with a monolithic 
kernel, which loads the entire OS at boot time. There are 
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Build a menu using the MDEF and 
then just handle menu selections like any 
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ASCII Chart ; 
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versions of this microkernel for several microprocessors. 

Linux — a kernel, drivers and applications which form a 
free, Unix-like system. It operates on various processors, 
including x86, 68K, and PowerPC processors, but not on all 
systems based on these processors. The Macintosh doesn't yet 
have a stable version of Linux. 

HURD - the GNU project’s Unix replacement. Hurd is an 
acronym for “Hird of Unix-Replacing Daemons”. Hird, in turn, 
is an acronym for “Hurd of Interfaces Representing Depth”. I 
mention this mainly because it’s a funny acronym. Lf you're a 
nird. — man | 





Designing and Building Parallel Programs, 
an online book 


http://www.mcs.anl.gov/dbpp/ 


The Java Developer Network 
http://www.digitalfocus.com/digitalfocus/faq/index.htm! 
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By Matt Neuburg, letters@mactech.com 








PASCAL FOREVER 
The following exchange is reprinted with permission from 
TidBITS #305 (27-Nov-95 -— email info@tidbits.com for more 
information). In that issue, Adam Engst interviews Peter N 
Lewis, author of Anarchie, FTPd, and other well-known 
shareware tools. We thought our readers might be interested in 
this excerpt, where Peter speaks about languages: 


Adam: You and Quinn are known for being major Pascal 
supporters in a development world that has largely gone 
over to C and C++. You even had anti-C t-shirts at the last 
few World-Wide Developer's Conferences. Without getting 
too technical, why do you continue to stick with Pascal, and 
does that cause problems at times? 


Peter: The normal C argument goes like this: “Everyone else 
is using C, so therefore it must be good.” Every Mac user 
should recognize that statement in a slightly different form, 
“Everyone else is using PCs, so therefore they must be good.” 


Basically, I continue to use Pascal because I’m more 
productive in it. I consider using Pascal to be a strategic 
advantage, doubly so when compared to C++. I’ve been 
reading a C++ book recently (know thine enemy), and every 
time I turn the page I see new ways to make tiny errors that 
are catastrophic and impossible to debug. I’m amazed that 
anyone can produce a working C++ program. 


However, programming in Pascal does cause occasional 
problems. The Apple interfaces tend to be quite broken. | 
wanted to try out QuickDraw GX, and it took a year of new 
versions before they finally got one that I could hack to work 
with Pascal. By then I'd given up on GX. In some ways this 
is actually a good thing for me: I have way too many projects 
and not enough time to do them all, so not being able to 
work with GX or OpenDoc is helpful for limiting my options. 


There has been, of late, mild criticism of the premises of the 
programmer's challenge, and now (Don Winston in November’s 
Dialog Box) of the style. 

I am only an amateur on the Mac, yet I find your magazine 
stimulating, thought-provoking and — hell, that’s enough praise 
for the moment. My views cannot in this case reflect those of 
the majority of your readers, but may correspond to those of a 
significant minority. 


DIALOG Box 


The demands have been: (1) to play down optimisation, 
arguing that hardware will catch up (the Microsoft approach), 
and now (2) the rejection of the use of “goto” in a winning 
answer; plus (3) that the programmer’s challenge become more 
practical or open itself up to more languages. 

That MacTech published these comments could mean two 
things (and most probably more): (1) it is an open forum for 
constructive criticism, including criticism of itself; (2) that it is 
preparing the minds of readers for changes in certain items. 

And it is this second possibility that worries me the most. 

The PC rules demand “correctness, speed, size and elegance 
(in that order of importance)”. While the first is obvious, the others 
are essential to the spirit of your magazine. Speed and size implies 
that you are looking at real joes working in front of real machines — 
we can't all just run out and buy PowerPC dream machines. Each 
time I have to launch W*rd 6 on our 660AV, I wince, scream and 
plead — I don’t want all software evolving into this. 

Elegance is subjective; it is in part what Don Winston is 
protesting about. He complains that “old notions of ‘efficiency’ 
are passé”. No, the Programmer's Challenge is a mindfest that 
makes one jump up and shout, “Yes, of course, it’s so obvious 
now!” It is one of those nuggets that I, as an amateur who would 
never consider entering the challenge, cherish. And to change 
these subtle criteria would diminish your magazine as a whole. 

Increasing the number of language platforms for the 
challenge has already been argued as impractical by the column’s 
flame-keeper in order for him to respect deadlines. Fine. 
Although I would be interested in the possibility to occasionally 
study just the winning algorithms, perhaps in pseudo code, rather 
than their implementations in a specific language, the crux of the 
challenge lies in the participants feeling/knowing the limits of the 
language, and then finding the best solution. 

That particular readers are not happy with specific subjects 
chosen for the challenge will always exist, but if you try to 
render it more “practical” for one group, another will protest 
that it is still further from their sphere of interest, and when one 
looks back over a year’s challenges it is a mighty varied lot: a 
little for everyone, and a lot for most. 

Keep up the good work. 

jonathan munn 
format@dialup francenet.fr 


Bob Boonstra Replies... 
Jonathan, 

Rest assured that we have no intention of changing the 
primary focus of the Programmer’s Challenge from efficiency to 
anything else. 
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Dialog Box continued from page 70 


The letter from Don Winston makes the valid point that 
improvements in technology have allowed software 
professionals to give other factors (usability, portability, 
encapsulation, reliability, etc.) greater consideration, at the 
expense of efficiency. But, as you point out, one need only 
look at the performance of some popular office automation 
applications to see that vendors are still able to generate 
sluggish code, despite the improvements in hardware. In fact, | 
believe that the demands on software will always exceed what 
the technology can support. The Challenge is intended to 
address techniques for those time-critical functions. It doesn’t 
pretend to be a balanced approach to teaching every aspect of 
software development. I think efficiency is still relevant — less 
universally so, but still relevant. 

It is gratifying to hear that you find most of the subjects 
chosen for the Challenge to be interesting. We strive to find a 
variety of problems that are interesting to readers, interesting to 
participants, sometimes useful, solvable in the limited time 
available, and scoreable in even less time. Suggestions from 
readers are always welcome. 

Thank you for your comments, and remember that anyone 
— including a self-described amateur — is invited to enter the 
Programmer’s Challenge. 

Bob Boonstra 
bob_boonstra@mactech.com 


Hooray FOR THE UMPIRE, THE PLAYERS, AND EVERYONE 
I just want to commend Bob on such an interesting challenge. 
[But which one is he talking about? Probably January's “Sliding 
Tiles”, we figure. - man] This is one of the few that I didn’t 
even know how to solve, let alone how to solve it efficiently. 
Hats off to anyone who breaks the brute-force barrier and 
applies some finesse to this one. 

The test code was excellent and invaluable. 

While I’m at it I'd also like to congratulate Eric Lengyel for 
such a clean solution to the Enclosing Bounds problem. | 
started working on it myself, but all of the various conditions 
(odd boundaries, different pixel sizes) made a simple-sounding 
problem too complex for the time I had. Eric, however, cut 
through the complexity and delivered some excellent code. 

Xan Gregg 


Want to get involved in the Dialog? Send your comments to 
our new, easy-to-remember email address: 
letters@mactech.com 
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Viewpoint continued from page 4 


FooD For THOUGHT 

“Inside Mac is not a more-or-less accurate description of the 
Toolbox. Inside Mac is the book by which developers write 
software. Therefore, if Inside Mac says a trap doesn’t move 
memory, you should read that as saying, ‘ten to twenty 
thousand developers have written code which assumes this trap 
does not move memory.” 

— Jorg bx’ Brown, on how AppleShare 3.6 patches Read 








Tips & Tidbits continued from page && 


THE PROBLEM WITH DOING ELLIPSES THE RIGHT Wav... 


Back in your January 1994 issue, Brett Bibby wrote a tip 
regarding how to erase extra “funky-looking characters” on 
double-byte (i.e. Japanese, Chinese, Arabic, etc.) systems. 

The characters appended to some menu items are caused 
not by the odd number of text characters but by the ellipse C..). 
The ellipse, as we all know, is supposed to be used on menu 
items that lead to dialog boxes, like New and Print. The 
ellipse you get by pressing option-; is the one you're supposed 
to use, according to page 67 of the Macintosh Human Interface 
Guidelines, but, in the Japanese character set, this and other 
option characters, such as the “registered trademark” sign and 
accents, are printed as hiragana, katakana, or parts of kanji 
characters (in other words, “funky-looking characters”). 

If you type in three periods (the “wrong” way), the ellipse 
appears properly. So, even though Apple tells us to use the 
“real” ellipse, if you want your product to be compatible with 
double-byte machines, you have to use three periods. Shucks. 

(Of course, the real way to make it compatible is to make 
another, localized version!) 

Luke Swartz 


FANCIER FINDS WITH DRAG AND DROP 

In CodeWarrior, if you need to find text in a batch of files or in 
a folder, open the Find dialog and drag the files or folders from 
the Finder onto the dialog and drop them. All the 'TEXT' files 
will be added to the list of files to search. 

Cool, huh! 

Tim Pedone 
[BBEdit does this too.— jtk] 
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Developer Job Opportunities 


If you are a Macintosh developer, you should register with 
us! We havea database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 


Marketability Assessment - To get a specific feel for your 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 


Discreet - We are very careful to protect the confidentiality 
of a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place- 
ment services and we are Mac fanatics. 


1-800-231-5920 * das@spi.com * Fax 1-800-757-9003 
http://www.scientific.com 


Scientific Placement, Inc. 


MT, Box 19949, Houston, TX 77224, 713-496-6100 Fax: 713-496-0373 

MT, Box 71, San Ramon, CA 94583 510-733-6168 beth@spica.bdt.com 

MT, Box 202676, Austin, TX 78720-2676 512-260-0123 lej@zilker.net 

MT, Kenmore Station, Box 15225, Boston, MA 02215 617-424-8372 jen@spbos.pn.com 
AppleLink: D1580; Compuserve: 71250,3001; eWorld: spi: AOL: davesmall “gy 
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“Our Server is loaded.” 
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—MacXperts 
Programmer 

& Volleyballer 
raves about 
having the best 
development 
toys anywhere. 


Programmers & 


Adventurers Wanted 


MacXperts is a software developer 
with immediate openings for 
Macintosh & Newton programmers 
with C, C++, OpenDoc, Java or other 
programming experience. 
Take the first step to adventure. 
Call Michael Ruttle at: 
1-800-356-8040 or fax / 804-358-3847 
AppleLink: xperts AOL: MacXperts 
http://www.macxperts.com/~xperts 

Internet: xperts@infi.net [ee 
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MACINTOSH SERVICES 


PUBLISH YOUR 
SOFTWARE FREE 


United Software Exchange 
will market your software 
nationally at no cost to you. 



















Interested? For no obligation 
information email Ralph at 
USoftEx@ aol.com or 
call (708) 582-7465. 







UNITED SOFTWAREEXCHANGE 








ES TRATTNER NETWORK 


COMPUTER CONSULTING SERVICES 


T he Trattner Network (TTN) has the best opportunities for Macintosh 


developers in Northern California and Nationwide. 


TN represents clients with projects in Internet, Multimedia, 
Codewarrior and OpenDoc development among others. 


N Ow you Can visit us Our web site at www.tratnet.com 
and see what openings are available for.... 


e Software Developers e Hardware/Firmware Engineers 


e QA/QC Professionals 


e Project Coordinator/Managers 


e Multimedia Developers e Network Professionals 
The Trattner Network has a unique history in Mac consulting 
coupled with exposure to emerging technologies. If you are 
looking for a chance to enhance your skills and marketability, 
please send, fax, e-mail or link your resume to: 


The Trattner Network 
Attn: Emily Hoolhorst 
170 State Street, Suite 240 * Los Altos, CA 94022 
Phone: 415°949°9555 ext.115 ; Fax: 415*949°1026 
Apple Link: trat.net ; E-mail: emily@tratnet.com 


http://www.tratnet.com 











MACINTOSH 
DEVELOPMENT MANAGER 


The Peter Norton Product Group of Symantec, 
makers of the award winning Norton Utilities, has an 
opportunity for a Macintosh Development Manager. 


Requirements include experience in hands-on design 
and development of software. Necessary skills include pro- 
ficiency in C and C++ and demonstrated expertise in soft- 
ware architecture, user interface design and technical lead- 
ership. Experience with Symantec C++ and Metroworks 


CodeWarrior desired. Knowledge of TCL, PowerPlant, 
and/or MacApp preferred. 


To apply, forward your resume and salary history 
to: Symantec Corporation, Attn: Professional Staffing, 
Dept. MacTech 4/96, 2500 Broadway, Suite 200, Santa 
Monica, CA 90404 or FAX to: (310) 828-0874 or 


e-mail to: recruiter@symantec.com Equal Opportunity 


Employer. 
SYMANTEC, 











_ By Matt Neuburg 





_ These are URLs (those that I was able to find) connected with the 
_ MacWorld Expo article (starting on p. 48), in the order in which 
— each company/product is mentioned. 


Hypercard itt //dev. info. ape com/solguide/HyperCard. html 

General Magic — - http:/ www. genmagic. com 
Seny a ery on comiSEUMagicindex hem ee 
Mainstay http: Jwww. lightbulb. com/tech/vipc SO 
- https! 1/204. 212. 150.4/ Bn 
Your Humble Managing Editor _hutp /www. friends. net/neuburg/ 


Apple - - ~ Dylan rt: /www. w.cambidge apple. comidylanidan html 
Apple - -APDA. 
Apple - “Opendoc i /hwww. opendoc. apple. com/ 


http: ‘IIdev. info. apple. comlapda. html Oo 


Kantara nt Www. partmerchant. com/ 


ConnectSoft “tp //www.connectsoft. comicrpproductsfee emc. shtml 
Apple — QuickDraw GX “http: ee info. apple. com/gx/gx. html 


Apple — - QuickDraw 3D rt: product. info. ale com/qd3d/QD3D. HTML 
Apple - - PowerTalk _ http: //dev.info. apple. com/evangelism/powertalk/powertalk. htm! 


Symantec http: JI. symantec. com/ 


Metrowerks http:/ //wwww.metrowerks.com/ 


AppMaker http://www. fairgate. com/am/index. shtml 


Motorola ‘Attp:// //www.mot.com/SPS/PowerPC/ 


Willows http: //www.willows.com 


— =~ verano ea ee 


Digitool http: Jw. digitool. com/ 


Quasar Knowledge Systems http: /IWww. aks. on 


Tenon http://www. tenon. com/ 


http:// www. pictorius. com/pi/welcome/ 


Breathing Software http: //www. info. -apple. com/dev/mdg/AnimationSolutions. html 
Everyday Objects http: JI. pla- -net.net/edo/ 


Everyware http://www.everyware.com/Tango_Intfo/ 
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Interface Builders — 


Natural Intelligence 


Late aul, 


Oracle 


—. 


MindVision 


Jasik 


Mathemaesthetics 


guideWorks _ 


Rainbow 


Bare Bones 


Terran Interactive 


= Sibi ee eee eee 


http://www.natural.com/ 


ee eee eet ver 


en oracle.com 


ion sladdinsys. Se eeomrree 


http://www. mindvision. com/ 


“http:/ www. jasik, com/ 


it /Idev.info.apple.com/solguide/Resourcerer.html 


nt /IWwww. gidewarks com/ 


it: /WWw. barebones, com/ 


http: //www.terran-int.com/ 








Adobe http://www.adobe. com/Acrobat/gethelp. html 


See a —— aol er teleport —- stack! See Ty 


Scientific Placement ——http:/ //vwww.scientific.com/ 


Heyertech http ‘www. ers comi ee eee 


al http: /Wwww. purity. com/ 
htto: /iwww.fsti.com/ 


Pacific Coast 
http://www.pacific-coast.com/St_Pages/PCSPages/datasheets/webcatalog.htm| 
Blueworld —_htttp://www.blueworld.com/macsite/searcher.html 
a 9 
http: /Iproduct. info. apple. com/qd3d/VRML20/Out_ Of_ This_ _World. HTML 
North Plains Systems http: Jw. ipsystems. com/nps/Equilnfo. html | 
Virtus http: /www.virtus. com/ 


Web Server 4D http: JW. mag. com/ 


MovieStar rt: /www. beingthere com! 


Dearie tr ae a pe eee se eee 


OnBase rt: /www. onbasetech. com/ 


CESoftware —_http:/www.cesoft.com 


Ardi http://www. ardi, com/ 


“hitoul rece oe =o een nes eee eee 


Ricochet Modem _ ___ http: /www.metricom. com/ricochet/manual/intro. htm 





A GATHERING OF URLS 


Special Messages: 


Note: While most of this site is complete, you may see some things still under construction. Please excuse 
“the mess". :) 


The Programmer's Henge is now availble on this web. Esch month, programmers compete to produce 
the fastest, tightest cade. 


Thenew MacTech CD is shipping at a new | 


Did you go to Macworld but forgot to get information from a developer tool vend or? 
Check out information on Developer Central sp onsored by Apple and MacTech. 


You've found your way onto the MacTech Web™ site. To date, you'll find some 1808+ pages of material 
here. The focus of this ste is to support the Mac™ OS programmer and developer community. Here you will 
not only find support for MacTech Magazine, but you ie get access to an nuraber of useful places on the net 
for Mac developers as well as formation on how to get the latest Macintosh 


Let us know what you think of the site. It's a living, breathing beast and we're here to improve #, change it, 
nurse # and grow 2. Our webmaster address is almost always available at the bottom of each page on this site. 


-- The fois at MacTech Magazine 
1042195 - 15:22 (PST) 





(Need we say more?) 


For Macintosh 
Programmers & Developers 











BBEdit 3.5 from Bare Bones Software is 
now better than ever. In 
BEA ection to being Acceler- 
ated for Power Macintosh, 
this powerful, intuitive text editor offers 
integrated support for THINK C 7.0, 
Metrowerks CodeWarrior 6, THINK 
Reference 2.0 and MPW ToolServer. 
Version 3.1 adds even more capability, 
including “soft” wrapping of text on screen 
and numerous refinements and 
improvements to the user interface. 
BBEdit’s many features include: Integrated 
PopupFuncs™ technology for speedy 
navigation of source code files (C, C++, 
Pascal, Rez, 68K Assembler, and Fortran), 
unique ‘Find Differences’ command 
(BBEdit can find differences between 
projects and folders as well as files), 
support for Macintosh Drag and Drop for 
editing and other common tasks, 
Powerlalk support for reading, sending 
and composition of PowerTalk mail, 
scripting via any OSA compatible scripting 
language including AppleScript and 
Frontier 3.0, and fast search and replace 
with optional “grep” matching and multi- 
file searching. BBEdit's robust feature set 
and proven performance and reliability 
make it the editor of choice for 
professionals and hobbyists alike. $99 


CodeManager by 
Metrowerks Is a source 
AXA code control system for the 
# # &% Macintosh that is based on 
wi and compatible with 
Microsoft Visual SourceSafe version 4.0. 





CodeManager works with any type of 
binary file including graphic, database, 
library and executable files. Features 
include support for multi-platform 
projects, security features, reverse delta 
versioning of files, comment areas for 
each revision, project analysis and 
reporting tools. CodeManager is sold on 
a subscription basis that includes two 
future product updates. Includes a 1 year 
MacTech subscription. $399 


CodeWarrior 8 

Gold Use Onde. Sep 
Warrior Gold to build 
W # & applications for the Mac OS, 
metrowers Windows 95, Windows NT, 
Magic Cap, and the new Be OS. The 
CodeWarrior development package 
includes C, C++ and Object Pascal 
compilers, source-level debuggers, object- 
oriented frameworks (PowerPlant, MacApp, 
MFC), Apple's MPW, complete online 
documentation and source code examples 
for all languages and platforms. The IDE 
software has been localized in eight 
languages plus English. CodeWarrior is 
sold on an annual subscription basis and 
has three major releases each year. 
Includes a 1 year MacTech subscription. 
Price $399 





CodeWarrior 8 
Bronze Use Code- 
Warrior to build applications 
for the Mac OS on 68K 
metrowerks eens The CodeWarrior 
development package includes C, C++ 





and Object Pascal compilers, source-level 
debuggers, object-oriented frameworks 
(PowerPlant, MacApp), Apple's MPW, 
complete online documentation and 
source code examples for all languages 
and platforms. The IDE software has been 
localized in eight languages plus English. 
CodeWarrior is sold on an annual 
subscription basis and has three major 
releases each year. Includes a 6 month 
MacTech subscrip-tion. Price $149 


Discover Programming 
for Macintosh 

The official Code- 

A # % Warrior Starter Kit includes 
mS full working version of 
CodeWarrior along with three online 
tutorial books and Dave Mark's "Learn C 
on the Macintosh" converted to Apple 
Guides. The development package 
includes C, C++ and Object Pascal 
compilers for generating 68K Macintosh 
code, source-level debuggers, object- 
oriented frameworks (PowerPlant, 
MacApp), Apple's MPW, complete online 
documentation and source code examples 
for all languages and platforms. The IDE 
software has been localized in eight 
languages plus English. This product is 
not sold as a subscription. Includes a 3 
month subscription. Price $79.00 





FaceSpan™ v2 is an extensible Rapid 
Application Designer (RAD) that 
RM rakes building applications 
quick and easy. It combines an 
interactive, visual interface design 





environment with the object-oriented 
power of AppleScript or any OSA 
language. Best of all, FaceSpan allows 
you to integrate the capability of 
scriptable programs into your custom 
application. Your FaceSpan applications 
can include any number of windows, 
dialogs, palettes, and menus. In them, 
you can display scrolling lists, popup 
menus, scrolling text, movies, multi- 
column tables, pictures, icons, buttons, 
and others. While no scripting is needed 
for standard behaviors, every item may 
have its own script. You can even 
program custom objects using Pascal or 
C. Try the perfect choice for MIS 
professionals, power users, consultants, 
and programmers. They ¥ FaceSpan! 
Includes a royalty-free distribution 
license, for unlimited runtime users, of 
your FaceSpan-based applications. Also 
included is a FREE UPGRADE to the next 
version for registered users. $499 $179 


A Fragment of Your 
Imagination by Joe Zobkiw. GQ», 


Here's some practical help for creating 
code resources and code fragments for 
the Macintosh and Power Macintosh. 
Rather than simply gathering and 
indexing chunks of this vital code, the 
author provides thorough explanations to 
teach you more about how the Macintosh 
system functions as a whole. He also 
provides hard to find information about 
techniques used to structure and build fat, 
Safe fat, and accelerated code resources 
for use on both 680x0 and Power 


MACTECH MAGAZINE PRODUCTS & ORDER INFORMATION 





E-mail, Fax, write, or call us. You may US Magazine with Source Code Disk: 


use your VISA, MasterCard or American 


Express; or you may send check or 
money order (in US funds only): 
MacTech Magazine, P.O. Box 5200, 
Westlake Village, CA 91359-5200, 


Voice: 805/494-9797, Fax: 805/494-9798 


If you are an e-mail user, you can place 
orders or contact customer service at: 


e AppleLink: MT.CUSTSVC 

e CompuServe: 71333,1063 

e Internet: custservice@xplain.com 
e GEnie: MACTECHMAG 


MACTECH WEB" SITE: 
http://www.mactech.com 
For complete product info 


SUBSCRIPTIONS 

US Magazine: $47 for 12 issues 
Canadian: $59 for 12 issues 
International: $97 for 12 issues 


$124 for 12 issues 


Canadian Magazine w/Source Code 


Disk: $136 for 12 issues 


International Magazine w/Source Code 


Disk: $194 for 12 issues 


CD-ROM 

MacTech CD-ROM, Volumes 1-10: 
Includes over 1230 articles from all 115 
issues (1984-1994) of MacTech 
Magazine (formerly MacTutor). All 
article text and source code. Now in 
THINK Reference format. The CD 
includes Symantec’s THINK™ Reference 
2.0, working applications with full 
documentation, product demos for 
developers and more. See 
advertisement, this issue: $49. 
Upgrades $39. 

E-mail, call or write for info. 


BOOKS 
The Best of MacTutor, Vol. 1: Sold Out 
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The Essential MacTutor, Vol. 3: $19.95 
The Definitive MacTutor, Vol. 4: $24.95 
The Best of MacTutor, Vol. 5: $34.95 
Best of MacTutor Collection, 


Volumes 3 — 5: $69 


Best of MacTutor, Volumes 6,7,8&9: 


Not available 


DISKS 
Source Code Disks: $8 each 
Topical Index (1984-1991) on disk: $5 


MAGAZINE BACK ISSUES 
Volumes 3, 4, 5, 6, 7, 8, 9 and 10: 


$5 each (subject to availability) 


California residents include 8.25% sales 
tax on all software, disks and books. 


Allow up to 2 weeks for standard 
domestic orders, more time for 
international orders. 


PLEASE NOTE 
Source code disks and journals from 


The Complete MacTutor, Vol. 2: Sold Out MacTech Magazine are licensed to the 


purchaser for private use only and are 
not to be copied for commercial gain. 
However, the code contained therein 
may be included, if properly 
acknowledged, in commercial products 
at no additional charge. All prices are 
subject to change without notice. 


SHIPPING & HANDLING 

California: 

Source disk or single issue: $3 

Single book or multiple back issues: $5 
Two books: $8 

All other orders: $12 


Continental US: 

Source disk or single issue: $3 

Single book or multiple back issues: $7 
Two books: $15 

All other orders: $17 


Canada, Mexico and Overseas: 
Please contact us for shipping 
information. 


MAIL ORDER STORE 





Want more product info? Call us at 805/494-9797 © E-mail us at productinfo@xplain.com 
Or for complete product info, see the MacTech Web™ site at http://www.mactech.com 
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Macintosh. All code is reusable and is 
provided on the disc, along with 
Metrowerks Code Warrior Lite. Book/CD- 
ROM, 528 pages $39-05 $35.96 


Inside CodeWarrior 8: 
Includes CodeWarrior IDE User's ap 
Guide. This manual shows you how to use 
the CodeWarrior IDE (Integrated 
Development Environment). It shows you 
bs how to create software for 
68K and PowerPC Mac OS, 
_ Win32/x86, and Magic Cap. 
It also shows you how to 
use ToolServer from the IDE 
and how to control the IDE 
using AppleScript. The next highlight is 
CW Error Messages, which describes the 
errors you might encounter while using 
CodeWarrior compilers and linkers. This 
manual contains descriptions, Source 
code examples, and fixes to these errors, 
as well as the Debugger Manual, which 
was updated for CW7 including new inline 
and exceptions debugging, and a new 
troubleshooting section. Next up is the 
MPW Tools Manual, which shows you 
how to use Metrowerks compilers, linkers, 
and other tools under the MPW Shell. 
Updated for CW/7, new chapters 
comparing Metrowerks and other MPW 
tools, and then onto C, C++, and 
Assembly, and Pascal Language 
Reference, covering the Metrowerks 
implementation of C, C++, and 680x0 
assembly language programming, 
updated for CW7. The Pascal refs also 
include the new UNSIGNEDWORD and 
UNSIGNEDLONG. Also included for this 
time are Profiler and ZoneRanger Manuals 
updated for CW8. $34.95 


Inside Macintosh®: CD-ROM by 
Apple Computer, Inc. Inside Macintosh is 
the essential reference for programmers, 
designers, and engineers for creating 
applications for the Macintosh family of 
computers. Inside Macintosh CD-ROM 
collects more than 25 volumes in 
electronic form, including: QuickDraw™ GX 
Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, 
Macintosh Toolbox Essentials and More 
Macintosh Toolbox, QuickTime and 
QuickTime Components. Now 
programmers will be able to access over 
16,000 pages of the information they need 
directly from their computers. Hypertext 
linking and extensive cross referencing 
across volumes allows programmers to 
search and explore this library in ways 
that are unique to the electronic medium. 
Every Macintosh programmer will regard 
Inside Macintosh CD-ROM as their most 
important resource. $99.95 





Inside PowerPlant jis the 
Power-Plant Manual, and contains Sp 
information about creating 
PowerPlant applications 
_ using the CodeWarrior IDE 

and PowerPlant 
Constructor, and describes 
major PowerPlant classes 


MAIL ORDER STORE 








and resources. Also included are the 
PowerPlant Constructor Manual, including 
View, TextIraits and Custom Types 
editing, and PowerPlant Library Reference, 
covering all classes and functions in 
PowerPlant, updated for CW8. $34.95 


Learn C on The Macintosh 
Second Edition By Dave 
Mark: Learn C on The Macintosh 
Second Edition: This is a completely 
revised edition of Learn C on The 
Macintosh. With this self-teaching, easy- 
to-understand book and the enclosed 
CD-Rom, you get everything you need to 
Start programming in this widely used 
language. New to this edition are 
updated and enhanced exercises that 
lead you step by step through the 
programming fundamentals and C 
language basics including function, 
variables, pointers datatypes, data 
structures, and the file input and output. 
Also new is completely rewritten code, 
plus answers and source code for all of 
the exercises. The new CD-ROM with 
Metrowerks Code Warrior™ Lite, a 
Special version of one of the hottest 
Macintosh programming environments, 
(including a PowerPC version). $34.00 
$31.45 


Macintosh Programmer’s Tool- 
box Assistant CD-ROM — Instant 
electronic access to Inside Macintosh 
essentials. Now Macintosh programmers 
can get quick access to over 4,000 
Toolbox calls that are at the heart of 
Macintosh system software. The 
definitions of these data structures, 
resources, constants, and functions are 
documented in the Inside Macintosh 
series and are essential information for 
anyone developing Macintosh software. 
Macintosh Programmer's Toolbox 
Assistant is a CD-ROM that harnesses the 
power of one of the best search and 
viewing engines in the industry. It allows 
programmers to access the Toolbox calls 
quickly from their development 
environment. With hypertext links 
allowing programmers to view related 
topics easily. Macintosh Programmer's 
Toolbox Assistant is the ultimate 
electronic reference tool for Macintosh 
programmers. $99.95 


Mastering the THINK 

Class Library by Richard 

Parker. Now that Symantec's long-awaited 
PowerPC native compiler is here, developers 
are taking another look at THINK. This book 
provides a thorough examination of 
Symantec's extensive Class Library and the 
Visual Architect, a graphic user interface 
development tool that allows you to produce 
commercial-quality applications with a 
minimum of effort. A complete description of 
the structure and operation of the TCL 
includes explanations of all code generated 
by the Visual Architect, any necessary 
custom code, and the operation of this code. 
Visual Architect tutorials provide you with a 
Step-by-step approach for simplifying the 


development of complex Macintosh 
applications. 496 pages $29-06 $26.96 


Movie Cleaner Pro is the 

most powerful and easy-to-use 

tool available for compressing QuickTime 
movies. Features include drag and drop 
batch processing, suspend and resume, 
high quality crop and resize, A/V fades, 
and much more. The built-in Movie 
Expert makes compression simple by 
suggesting the best settings for your 
application. Well suited to both beginners 
and experts Movie Cleaner Pro is 
essential for any CD-ROM or Web site 
which contains QuickTime video. $129 


NeoAccess’ is a high-perfor- 
mance, full-featured abject ep 
database engine for use in 
Macintosh, Windows, Unix and DOS 
based C++ applications. Behind an 
elegant programming interface is a high 
performance object database engine 
which delivers the power you need: 
extended binary trees and binary search 
algorithms tuned for short access 
times, dynamically combined, 
collapsed, and compressed indices, and 
object caching for nearly instantaneous 
access to previously used objects. 
Thousands of commercial and in-house 
developers have already found that 
NeoAccess enabled them to build fast, 
powerful applications in record time. 
That is why NeoAccess based 
applications are already operating on 
millions of computers. $749 


OOFILE is the first OODBMS 
framework to offer a complete ey 
solution for application authors. 
Replaceable backend database, currently 
Faircom’s c-tree Plus for cross-platform 
royalty-free power. PowerPlant and other 
frameworks integrated with edit fields, 
database browsers & more. AppMaker 
users, generate complete applications. 
User-friendly syntax makes it easier to 
migrate from FoxPro and the non-00 
world. Demo’s on CodeWarrior and 
AppMaker CD's. $900 for a once-off c- 
tree bundle, or $1,095 1-year 
Subscription.HTML and character-mode 
report-writer $195. Full GUI report-writer, 
including HTML, is $495. Mac Platform 
Bundle - includes all Mac frameworks, c- 
tree, and Report-Writer. $1,495 


PowerTap”™ accelerates soft- 
ware by tapping into multiple Sap 
processors. Version 3.0 taps into 
networked Macs and all processors 
found in the new multi-processor Macs. 
Speed up your applications without 
learning networking, communications 
and task scheduling algorithms. The 
Powerlap™ library has the easiest API - 
it behaves as a simple black box - submit 
tasks and retrieve results. With its built in 
full error recovery, your job will complete 
no matter what. PowerTap's advanced 
scheduling algorithms ensure optimal 
assignments and fastest possible 


execution. Compatible with all Macintosh | 
hardware, software and major compilers. 
Powerlap/2, 2 Remote edition $1200: | 
Powerlap/5, 5 Remote edition $1900: 
PowerTap/n, Unlimited edition $2700. 


QC™ by Onyx Technology, is a system 
extension that stress tests code during 
runtime for common and not-so-common 
errors. Tests include heap checks, 
purges, scrambles, handle/pointer 
validation, dispose/release checks, write 
to zero, de-reference zero as well as other 
tests like free memory invalidation and 
block bounds checking. QC is extremely 
user friendly for the non-technical tester 
yet offers an API for programmers who 
want precise control over testing. QC is 
Also available in Japanese. $99.95 


Roaster DR2™— Be the first Macintosh 
developer on your block to take advantage 
of the unique capabilities of Sun’s new 
Java” Programming Language! Developer 
Release 2 of Roaster” new from Natural 
Intelligence Inc., is the first ever 
development environment for writing, 
testing and running Java™ applets on the 
Macintosh. Features include: project 
window that includes a finder-like view of 
packages, lightning-fast, Macintosh 
native compiler, Source code editor with 
powerful search features and intuitive use 
interface, runtime engine for quick and 
easy applet testing. When you purchase 
Roaster”, you are entitled to: unlimited 
tech support throughout the length of 
your subscription. FREE updates to, and 
including the second commercial release 
of Roaster. Roaster” is accelerated for 
Power Macintosh. Requirements 
Macintosh or Macintosh compatible 
computer with a Power PC processor: 
2MB RAM; Color QuickDraw; system 
7.1.2 or later; CD-ROM drive to install the 
software. Price $399 Special $299 


Scripter® The Authoring and Development 
Environment for AppleScript™. Scripter, the 
37g ocript Construction Set, is the 
foremost, comprehensive tool for 
ou and debugging 
AppleScrit scripts. Scripter is a shortcut to 
Applescript’s full capabilities, is both 
powerful and easy to use, and appeals 
equally to novices and experts. Scripter offers 
the largest collection of tools to answer the 
needs of every AppleScript user, containing 
over 35 features, including: Superior 
vocabulary access — point-and-click 
assembly of commands and object 
specifications; command window for 
experimentation. Shortcuts and extended 
editing capabilities — extensive drag-and- 
drop, six-function find-and-replace; 
navigation markers; script library collection 
facility; many other timesavers for faster 
scripting. Interactive debugging — 
comprehensive variable watcher, expression 
evaluation, enhanced trace log, and real 
single step debugging! Other features 
include: integration with FaceSpan and 
background processing. Unlike other 
scripting tools, which are either based on the 
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Original Script Editor concept, or are 
designed to look more like traditional 
programming tools, the designers of Scripter 
understood from the outset that scripting is 
different from writing C code. Scripter will 
change the way you work with AppleScript. 
From expert script design to user-friendly 
editing and implementation, Scripter is the 
natural companion to AppleScript for all levels of 
proficiency. $499 $179 


ScriptWizard™ 1.5 is the latest 
version of the best-selling script: Sp 
editing and debugging tool that 

combines the power of a professional 
development environment with the ease of 
use that you expect of Macintosh™ software. 
Compatible with all Apple® Open Scripting 
Architecture languages, including 
AppleScript™, ScriptWizard improves your 
productivity by delivering testing and 
debugging facilities that are as intuitive as 
they are powerful. ScriptWizard makes life 
easier for scripters by emphasizing features 
that speed script development. Some. of the 
most significant enhancements to scripter 
productivity include the ability to single-step 
scripts (now allowing true statement-level 
Stepping), watch variable values as scripts 
execute, jump instantly to frequently used 
places in a script and find and replace specific 
text. Full drag and drop text editing is 
supported. ScriptWizard delivers an intuitive 
development, testing and debugging 
environment for rapid script creation with 
essential tools up-front for easy access. $89 


Symantec C++ for 68k, allows you 
to build applications faster and easier with 
the powerful combination of fully integrated 
visual tools and the latest in C and C++ 
compiler technology. C++, now the 





Applied Mac Scripting 
Applied Mac Scripting covers Rp 
AppleScript™, Frontier, QuicKeys, Tempo 
ll, nShell, FaceSpan Application Builder, 
Scripting PlainTalk and System 7.5. With 
this hands on tutorial Tom Trinko shows 
you how to automate your Macintosh 
activities by learning how to use the 
AppleScript and Frontier scripting 
environments. You will learn the overall 
approach to designing and developing 
powerful scripts, and to harness the 
capabilities of a wide variety of Macintosh 
applications into the integrated 
productivity tools. This includes such 
things as the newspaper script which 
combines the power of SlTcomm, 
MacWrite Pro, and Filemaker Pro, or 
QuarkXpress. Whether you are a power 
user or experienced Mac Programmer you 
will learn valuable new techniques for 
Mac automation. $84.06 $31.45 


Basic For The Newton, Program- 
ming for the Newton Using NS Basic by 
John Schettino & Liz O'Hara. This book 
shows owners of Newton devices how to 


Want more product info? Call us at 805/494-9797 + E-mail us at productinfo@xplain.com 


Or for complete product info, see the MacTech Web” site at http://www.mactech.com 


Standard in development languages, 
provides an object-oriented approach to 
application development, and the resulting 
code is extensible, reliable, and 
maintainable. Includes: Integrated 
Environment with full source-code 
debugging, integrated editing and 
browsing, and resource creation and 
editing; support for standard language 
features such as templates and multiple 
inheritance as well as quick compile times 
and highly optimized code; Incremental 
Linker which eliminates long link times; 
THINK Class Library — a mature, C++ 
based, application framework provides a 
solid foundation on which to build factored 
and scriptable applications with support for 
C++ exceptions, run-time type 
identification, persistent objects, and 
AppleEvents; Visual Architect™ to visually 
design your user interface and automatically 
generate complete THINK Class Library 
source code; THINK Inspector which 
provides you with quick and easy 
navigation of your application's class 
hierarchy while it is running; Project 
Models to start new projects quickly from 
templates either provided in this package or 
created to fit your own needs; Source-Code 
Control with integration with Apple's 
SourceServer (included) provides reliable 
version control and supports team 
programming; Support for Scripting lets 
you automate complex, multiproject 
operations using AppleScript or Frontier 
scripting; Powerful Standard Libraries 
which includes 10 Streams, ANSI standard 
C library, and sample programs. Full 
Source code is included; Extensibility 
Supports third-party editors, and 
AppleScript and MPW tools (available from 
Apple) and allows access to THINK 


become Newton programmers using 
BASIC. The authors use a straight-forward 
“programming by example’ approach, 
which should have you writing your own 
Newton programs right away. It includes 
one 3.5" disk containing Demonstration 
NS BASIC and over fifty example 
programs from the book. It is Multi- 
platform in that teaches programming for 
the Newton using a Macintosh, a 
Windows-based PC, or on the Newton 
device itself. $86-05 $32.35 


C++ Programming With 
CodeWarrior Beginning 
OOP for the Macintosh and 
Power Macintosh by Jan L. 
Harrington from AP 
Professional. This book shows 
programming novices object-oriented 
programming techniques for the 
Macintosh, Power Macintosh, and Mac OS 
compatibles, using C++ as the example 
language and Metrowerks and 
CodeWarrior as the example compiler. The 
enclosed CD-ROM contains example code 
from the book and a full-function 
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Reference; Create applications; desk 
accessories; device drivers; and any kind of 
code resource, including HyperCard 
XCMDs and XFCNs, system extensions, 
and control panels; Migration Path to Power 
Mac — Create applications that run on 68K 
Macs and Power Macs (emulated). These 
applications can easily be migrated to native 
Power Mac, by trading up to Symantec C-+- 
for Power Mac. Competitive Upgrade $79 
PEA icusty-stoncra Macintosh 

development system--and now 
it's native for Power Mac. You can 
develop full-featured Power Macintosh 
applications quickly and easily using 
revolutionary new features that save time 
and enhance your productivity throughout 
the development cycle. Environment 
includes: A true native Power Mac 
implementation of the C++ language, 
including support for templates and 
multiple inheritance; MrC/MrC++ 
compilers for fast Power Mac executable 
code (22% faster than with the standard 
Symantec or Metrowerks compilers); Visual 
Architect for fast, easy GUI generation; A 
new THINK project management system 
that supports large, complex applications, 
nested projects, and hierarchical project 
organization; A new editor/browser that 
displays classes and automates many 
editing functions; A powerful, easy-to-use 
source code debugger; The industry- 
standard THINK Class Library; Free 
subscription—receive the next two updates 
free when you send in your registration card 
and more! Competitive Upgrade $149 


Symantec C++ 8.4 is the 





Tricks of The Mac Game 
Programming Gurus is the 


BOOKS 


Metrowerks CodeWarrior compiler for 
running these examples. $36-96 $32.35 


The Complete AppleScript® 
Handbook by Danny Goodman is a self- 


contained kit to customizing and 
enhancing the Macintosh 
environment. The disk contains 


AppleScript 1.1 Runtime, Chang 
Labs TableServer, and useful, ready-to-run 
scripts. It also shows the Mac user how to 
automate many processes — no programming 
experience necessary. $3608 $31.50 


The Complete HyperCard® 2.2 
Handbook Fourth Edition by Danny 
Goodman is the biggest-selling Mac book 
— newly revised and updated for version 
2.2. It shows how to build working 
applications using the latest version of 
HyperCard and covers text, painting tools, 
extension commands (XCMDs), scripting 
in HyperTalk, and more. $36-08 $31.50 





The Computer’ Privacy 
Handbook is a practical guide to e- 
mail encryption, data protection, and 


ultimate resource for beginning to expert 
game programmers who already have 
general programming experience. Complete 
overview of all the necessary components of 
game programming on the Macintosh. 
Hundreds of tips, tricks, and insider secrets 
from Mac game programming experts on a 
CD-ROM, packed with valuable tools, 
utilities, sample code, Code Warrior™ Lite 
and game demos. Coverage of cutting-edge 
topics such as QuickDraw 3D and Power 
Mac optimization and inside info on how 
Glypha Ill was created. Unique in the 
marketplace — no other Mac game 
programming book is this complete! The 
book contains instruction, tips, and source 
code from the top names in Mac game - 
development today. The secrets, examples, 
and code can't be found anywhere else! 
These are the tried-and-true tricks that work 
behind the scenes in the most popular 
commercial and shareware Mac games. 
Throughout the book, you'll find special 
interviews with some of the most well-known 
Mac game programmers. They reveal their 
secret solutions created while they developed 
their popular games. $66-08 $45.00 


|Versions of outdated jdocuments jorganized orthogonally 


vooD00 v 1.7 is the ultimate 
version control solution for single 

and multi-author projects. Unlike other 
systems, VOODOO records changes to 
binaries, so it tracks all possible file 
types. With its graphical interface, you 
can manage entire projects efficiently. 
Single license $229. 2 pack $359. 5 pack 
$799. 10 pack $1369. 20 pack $2399. 


PGP privacy software. With millions of 
e-mail messages and on- 
line discussions exchanged 
daily on the Internet, 
electronic security has 
become a key concern. The 
Computer Privacy Handbook explains 
practical steps individuals can take to 
safeguard their electronic security. 
$2405 $22.45 


Cyberpunk Handbook, The Real 
Cyberpunk Fakebook by St. Jude, 
R.U.Sirius, and Bart Nagel. Published by 
Random House. This book tells how to 
tell if you or Someone you know is a 
Cyberpunk. $9-95 $8.95 


Danny Goodman's 

Apple Guide Starter Kit 

by Danny Goodman and 

Jeremy Joan Hewes. Two highly 

respected experts offer a different approach 
for creating your own Apple Guide 
databases. With Danny's Guide Starter 
program you can make guides quickly and 
easily, without having to learn a scripting 
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language, write coded files, or use several 
different files and programs to produce 
your database (which is what you'd have to 
do without the program). The authors 
provide advice and tips on how to design a 
good Guide, from planning and creation 
through testing, revising, and indexing. 
Book/disk, 320 pages. $3495 $31.46 


Danny Goodman’s 
AppleScript Handbook 
second Edition by Danny 
Goodman is a self-contained 
kit shows the reader how to customize and 
extend the capabilities of any Macintosh 
computer — no programming experience 
needed! This enhanced and expanded 
edition of The Complete AppleScript 
Handbook focuses on putting AppleScript 
to work in all sorts of practical situations. In 
addition, Danny shows you how to apply 
the same principles to other popular 
scripting systems, such as UserLand 
Frontier and QuicKeys. Shows readers how 
to use scripts to enhance the Macintosh 
environment, automate many processes, 
link data between applications, and much 
more. This book provides a wealth of all- 
new examples showing how to integrate 
AppleScript with the Finder, spreadsheets, 
desktop publishing programs, graphics 
applications, databases, telecommuni- 
Cations programs, utilities, and HyperCard. 
The accompanying 3 1/2" disk is jam- 
packed with over $100 worth of software, 
including AppleScript 1.1, valuable 
utilities, and powerful, ready-to-use 
scripts. $89-08 $35.00 


Danny Goodman’s Macintosh® 
Handbook Featuring System 7 by 
Danny Goodman with Richard Saul Wurman. 
It includes over 100 spreads break down and 
Clarify Mac problems and includes insider's 
tips. $20:05 $26.95 


Dan Shafer Presents the Power of 
Prograph CPX is a hands-on, project- 
Centered approach to learning the most 
revolutionary object-oriented 
programming language on the 
planet. The language Kurt 
schmucker likes best. The 
language that programmers 
actually report having “fun” programming. 
This 550-page book takes you step by step 
through three interrelated projects of 
increasing complexity. Along the way you'll 
learn the underlying Prograph language, how 
to use the power of lists, and the important 
aspects of the CPX classes and object 
editors. Includes disk with all code in the 
book. $49-05 $44.95 


The Elements of E-Mail Style by 
Brent Heslop and David Angell. Learn the 
rules of the road in the e-mail age. 208 
pages. $44.95 $13.45 


E-Mail Essentials by Ed Titte! & 
Margaret Robbins is a hands-on guide to 
the basics of e-mail, the ubiquitous 
networks communication system. The 
book is suitable for both the casual e- 
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mailer and the networking professional, as 
it covers everything from the installation 
of e-mail to the maintenance and 
management of e-mail hubs and message 
servers. 250 pp. $2496 $22.45 


Essential OpenDoc by GQ» 
Anthony Meadow and Jesse Feiler. 
OpenDoc is the revolutionary new 
approach to programming personal 
computers, central to the future of 
Macintosh, Windows, and 0S/2 platforms. 
Using OpenDoc allows programmers to 
assemble “parts” to create specialized 
programs, which are document-centric, 
rather than application-centric. Essential 
OpenDoc provides the first technical, 
cross-platform overview for this hot new 
technology. $39-95 $35.95 


Foundations™ of Mac® 
Programming by Dan Parks 
Sydow. This all-inclusive tutorial plus 
reference explains the fundamentals of Mac 
programming, from resources and memory 
management to including sound and 
QuickTime movies. On the CD: reusable 
Example code for Symante C-+- 8.0 or later 
and Metrowerks Code Warrior compilers, 
plus shareware and public domain goodies 
and a searchable form of the book itself. 
708 pages, plus one CD-ROM. $39.99 


A Fragment of Your Imagination 
by Joe Zobkiw. See page 77 


Global Interface Design, 
A Guide to Designing Inter- 
national User Interfaces by Tony 
Fernandes, AP Professional. Global 
Interface Design addresses the issues 
involved in product development for a 
global market with a “real world” focus. 
While covering major areas developers 
should address during the development 
cycle, Tony Fernandes provides insight 
into researching cultural differences. This 
book examines the differences found all 
Over the world, such as cultural 
symbolism and taboos, and how they 
impact user interfaces. $8495 $32.35 


Graphic Gems V Edited by Alan W. 
Paeth is the newest volume in The Graphic 
Gems Series. It is intended to provide the 
graphics community with a set of practical 
tools for implementing new ideas and 
techniques, and to offer working solutions 
to real programming problems. These tools 
are written by a wide variety of graphics 
programmers from industry, academia, and 
research. The books in this series have 
become essential, time-saving tools for 
many programmers. It is the latest 
collection of graphics tips in The Graphic 
Gems Series written by the leading 
programmers in the field. It contains about 
90 new gems displaying the most recent 
and innovative techniques in graphics 
programming. Also included is new gems 
in ellipses, splines, Bezier curves, and ray 
tracing. Includes a disk which contains 
source code from all five volumes and is 
available in both IBM and Macintosh 


versions. CONTENTS: Algebra and 
Arithmetic. Computational Geometry. 
Modeling and Transformation. Curves and 
Surfaces. Ray Tracing and Radiosity. 
Halftoning and Image Processing. Utilities. 
$49.05 $44.95 


Guide to Macintosh System 7.5 
by Don Crabb. $2500 $22.50 


How To Write Macintosh Software 
by Scott Knaster is a great source for 
understanding Macintosh programming 
techniques. Drawing from his years of 
experience working with programmers, Scott 
explains the mysteries and myths of 
Macintosh programming with wit and 
humor. The third edition, fully revised and 
updated, covers System 7 and 32-bit 
developments, and explores such topics as 
how and where things are stored in memory: 
what things in memory can be moved 
around and when they may be moved; how 
to debug your applications with MacsBug; 
how to examine your program's code to 
learn precisely what's going on when it runs. 
448 pgs. $28-95 $26.05 


Hooked on Java by Arthur 
van Hoff, Sami Shaio, and Orca Sep 
Starbuck. Java, a revolutionary object- 
oriented programming language designed 
by Sun and supported by Netscape, is the 
hottest new development in World Wide 
Web technology. Hooked on Java shows 
how to use Java “applets” small Web 
programs, to bring audio, animation to, and 
graphic effects to HTML pages. All Java 
applets in this book are on the CD-ROM, 
ready to plug into a home page. Also 
included will be examples of HTML home 
pages, plenty of Java source code, and the 
Java Development Kit for windows-95, 
Windows-NT and Solaris 2.x. (Note: Mac 
tools not included) $29-95 $26.95 


HyperTalk® 2.2: The Book Second 
Edition by Dan Winkler, Scott Kamins, and 
Jeanne DeVoto is the most complete, 
authoritative source on HyperTalk 2.2 
Programming and troubleshooting. It 
covers each language element of HyperTalk 
2.2 (including the odd quirk or bug). 
$36-08 $31.50 


Inside CodeWarrior 8: See page 76 
Inside PowerPlant: See page 76 


The Instant Internet Guide by 
Brent Heslop and David Angell. An Internet 
jump-start — how to access, use and 
navigate global networks. 224 pages 


$4408 $13.45 


Learn C on Late Night 
With MacHack covers ne ep 
MacHack conferences from their inception 
in 1986, up to 1993. Doug Houseman is 
the program Chairperson of MacHack, and 
the author of this book. The 
accompanying CD contains over 100 of 
the best hacks written at MacHack over the 
years, including The Grouch, NetBunny, 


Jurassicon Park, DropSave, QuickTime 
Balloon Help, the Mac Clapper, Wavy, and 
more... $20-05- $26.95 


Learn C++ on the Macintosh by 
Dave Mark. After a brief refresher course 
in C, Learn C++ introduces the basic 
syntax of C++ and object programming. 
Then you'll learn how to write, edit, and 
compile your first C++ programs through 
a series of programming projects that 
build on one another as new concepts 
are introduced. Key C++ concepts such 
as derived classes, operator overloading, 
and iostream functions are all covered in 
Dave's easy-to-follow approach. 
Includes a special version of Symantec 
C++ for Macintosh. Book/disk package 
with 3.5" 800K Macintosh disk. 400 
pages, $36-05 $33.26 


Learn C on The Macintosh Second 
Edition By Dave Mark: See page 76 


Learn HTML on the 
Macintosh by Dave Mark and 

David Lawrence. Gives Mac users a 
thorough grounding in HTML 3.0, the new 
version of HyperText Mark-Up — the 
language of choice for the World Wide 
Web. Users will learn all the latest features 
— such as tables, horizontal centering of 
text, and new support for inline figures — 
that make HTML 3.0 a much more design 
friendly Web standard than the previous 
version. An accompanying CD-ROM 
contains Mac utilities for creating 
multimedia Web pages. $20-95 $26.95 


The Mac Bathroom 
Reader by Owen inzmayer. Way 
Amaze your friends with your in-depth 
knowledge of Macintosh history. This 
book of trivia anecdotes, quotes and more 
includes a complete list of Apple’s code 
names for all its products, published here 
for the first time. $4+2-09-$11.70 


Macintosh C Programming Primer 
Volume I, Second Edition, Inside 
the Toolbox Using THINK C by Dave 
Mark and Cartwright Reed. This new 
edition of this Macintosh programming 
bestseller is updated to include recent 
changes in Macintosh technology, 
including System 7, new versions of 
THINK C and ResEdit, and new Macintosh 
machines. Readers will learn how to use 
the resources, Macintosh Toolbox and 
interface to create stand-alone 
applications. 672 pages, $26-95 $24.25 


Macintosh C Programming 
Primer Volume II, Mastering 
the Toolbox Using THINK C by 
Dave Mark. Volume II picks up where 
Volume | leaves off, covering more 
advanced topics such as: Color 
QuickDraw, THINK Class Library, 
TextEdit, and the Memory Manager: 528 
pgs. $26-95 $24.25 


Macintosh® Crash Course by Glenn 
Brown shows Macintosh power users what 
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to do when things go wrong with their 
system. Macintosh Crash Course shows 
readers how to overcome Macintosh system 
crashes, system lock-ups, and various, 
frustrating and cryptic error messages they 
regularly encounter. It includes a CD-ROM 
with shareware and freeware to help the user 
diagnose and repair system failures. 
Includes up-to date coverage through 
Macintosh System 7.5, Managing memory, 
Hardware diagnostics, File recovery, 
PowerBook problems, PowerPC problems, 
network utilities, hard drive repair utilities, 
SCSI problems, conflicts and solutions and 
File synchronization and utilities. $20-05 
$26.95 


Macintosh OLE2 Programmer's 
Reference: Working With 
Objects: Provides a complete reference 
to the extensible protocol of Object 
Linking and Embedding, version 2.01 for 
Macintosh System 7. Understanding of 
C/C++ helpful, but not necessary, and 
comes with a CD. Working With Objects 
describes the visual and interactice 
interfaces that support the component 
objects, provides details of the OLE 2.01 
for the Macintosh user Interface, 
addresses the issues of object class 
registration, shows how to implement the 
drag and drop objects from one 
application to another, covers the interface 
that exposes the basic embedding 
functionality, and includes descriptions of 
API functions. $4495 $40.45 


Macintosh Pascal Programming 
Primer Volume I, Inside the 
Toolbox Using THINK Pascal by 
Dave Mark and Cartwright Reed. This 
tutorial shows programmers new to the 
Macintosh how to use the Toolbox, 
resources, and the Macintosh interface to 
create stand-alone applications with 
Symantec’s THINK Pascal. 544 pages 
$26-05 $24.25 


Macintosh Programming Tech- 
niques by Dan Sydow (Series Editor: 
Tony Meadow). This tutorial and 
handbook provides a thorough foundation 
in the special techniques of Macintosh 
programming for experienced Macintosh 
programmers as well as those making the 
transition from DOS, Windows, VAX or 
UNIX. Emphasizes programming 
techniques over syntax for better code, 
regardless of language. Guides the reader 
through Macintosh memory management, 
QuickDraw, events and more, using 
sample program in C++. Disk includes an 
interactive tutorial, plus reusable C++ 
code. $34.05 $31.95 


Mac Screamer, The Ultimate 
Macintosh® Supercharging Kit by 
Jan Harrington covers 30 Macintosh models, 
including the Classics, LCs, PowerBooks, 
and Quadras and gives software solutions 
and hardware tips to accelerate Mac 
performance. It lets readers in on do-it- 
yourself tips that can save them over 25% on 
upgrade costs. $36-08 $31.50 


Macworld Ultimate 
Mac Programming by 
Dave Mark. Reveals the 
secrets of Mac programming 
and presents important, timesaving 
techniques. $39-06 $35.95 


Mastering the THINK Class 
Library by Richard Parker. See page76 





Metrowerks CodeWarrior Pro- 
gramming by Dan Parks Sydow. 
Includes CodeWarrior Lite, and Full 


Coverage of PowerPlant™. 
The best information on 
Metrowerks CodeWarrior 6, 
giving full coverage to the 


Gold Edition. Even if you dont already 
own CodeWarrior 6, you'll still be able to 
work with the examples in this book, 
using the CodeWarrior 6 Lite CD that 
comes with it. $80-05 $35.95 









More Mac Programming GW, 
Techniques: More Mac 
Programming Techniques goes beyond the 
fundamentals of Macintosh programming 
With this hands-on guide and tutorial, 
you'll expand on the basic foundation of 
programming to develop truly powerful 
applications. Inside you will take a detailed 
look at the units of a Macintosh program — 
from the INITs to custom controls. Along 
the way, you'll learn solid techniques you 
can apply anywhere, including tricks and 
techniques. You will learn file resources 
from the ground up, and how to build 
custom menus, add custom controls, 
including buttons, and slider controls, 
MDEF, and CDEF resources. The book will 
also help you to handle INITs, making 
preference files, and how to print flawlessly 
from your programs. $89-95 $35.95 


Multimedia Authoring: Building 
and Developing Documents by 
Scott Fisher addresses the concerns that 
face anyone trying to create multimedia 
documents. It offers specific advice on 
when to use different kinds of information 
architecture, discusses the human-factors 


~ concepts that determine how readers use 


and retain information, and them applies 
these findings to multimedia documents, 
covering the high-level issues concerning 
planners and authors of multimedia 
documents as well as those involved in 
evaluating or purchasing multimedia 
platforms. Includes one 3.5" high-density 
disk. $84-05 $31.45 


Multimedia Starter Kit for 
Macintosh by Michael D. Murie. This 
hands-on book offers the latest and greatest 
in multimedia for the Mac! Readers learn 
how to design their own multimedia projects 
step by step, then try it themselves with the 
demos, graphics, clips, and sample projects 
on the CD-ROM! CD-ROM contains 
QuickTime, sound and graphics clips and 
utilities, sample projects, and more. How to 
choose and use a variety of Macintosh 
multimedia tools and presentation 
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environments. Includes demos of Adobe 
Illustrator, Premiere, Heizer Software 
programs, and more $3008 $27.00 


Optimizing PowerPC Code: 
Programming the PowerPC in 
Assembly Language -— Jo take full 
advantage of the potential of 
the PowerPC, Developers 
need to master the Assembly 
Language techniques. This 
book shows how to use the Assembly 
Language in PowerPC Programs to 
produce faster more robust software. 
$30-05 $35.96 


PCI System Architecture, 
Third Edition by Mindshare, ay 
Describing revision 2.1 of the Peripheral 
Component Interconnect (PCI) bus 
specification, this book explores PCI's 
relationship to the rest of the system. It 
includes an in-depth treatment of PCI to PC! 
bridges, the PCI BIOS, the 66MHz PCI bus, 
and more. 592 pages. $34.95 $31.46 








Planning and Managing Web 
Sites on the Macintosh by 
Weiderspan and Shotten. This book is a 
definitive guide to setting up andrunning a 
Web site on the Macintosh, written by two 
experts in the feild. It skillfully teaches you 
everything you need to know about using 
WebSTAR, the best known HTTP server 
software and its shareware predecessor 
MacHTTP, as well as about writting CGI 
applications for your server. A special 
version of WebSTAR, plus tons of useful 
software, are on the CD-ROM. $35.96 


Power Macintosh Programming 
Starter Kit by Tom Thompson. This is 
the first tutorial/reference for programmers 
who want to enter the new world of the 
PowerPC chips. Users find all the details 
on the new microprocessors, the new 
RISC architecture, and how to write native 
code and emulation operations to create 
their own software for the Macintosh 
PowerPC. CD-ROM includes a unique 
compiler for writing code easily. The all- 
in-one book that gets programmers the 
information and tools they need. 
Programming examples reinforce 
explanations of code and programming 
tools $39-00 $35.10 


PowerPC System Architecture 
by MindShare. This book describes the 
hardware architecture of PowerPC 
systems, providing a clear, concise 
explanation of the PowerPC specification, 
the template upon which all PowerPC 
processors are designed. The author 
provides a complete description of the 
specification for both the 32- and 64-bit 
implementations. 656 pages $3405 
$31.46 


Profit From Experience by 
Dr. Gilbert F. Amelio, Apple's new Gy 
Chief Executive Officer. What will happen to 
Apple Computer, now that Dr. Gil Amelio 
has taken over as Chairman and CEQ? This 


work provides a detailed blueprint of the 
corporate strategy and business philosophy 
which Amelio is sure to bring to his new 
company. $2499 $22.45 


Programming for System 7 by Gary 
Little and Tim Swihart, is a hands-on guide 
to creating applications for System 7. It 
describes the new features and functions of 
the operating system in detail. Topics 
covered include file operations, cooperative 
multitasking, Balloon Help, Apple events, 
and the File Manager. Numerous working 
C code examples show programmers how 
to take advantage of each of these features 
and use them in developing their 
applications. 384 pages. $26-06 $24.25 


Programming for the Newton 
Software Development with 
NewtonScript by Julie McKeehan 
and Neil Rhodes. Foreword by Walter R. 
Smith. Programming for the Newton: 
Software Development with NewtonScript 
is an indispensable tool for Newton 
programmers. Readers will learn how to 
develop software for the Newton on the 
Macintosh from people that developed 
the course on programming the Newton 
for Apple Computer. The enclosed 3.5" 
disk contains a sample Newton 
application from the books, as well as 
demonstration version of Newton Toolkit 
(NTK), Apple Computers complete 
development environment for the 
Newtons. A Publication of AP 
Professional May 1994, Paperback, 393 
pp. $20-05 $26.95 


Programming in Symantec C++ 
for the Macintosh by Judy May and 
John Whittle. This book will introduce you 
to object-oriented programming, the C++ 
language, and of course Symantec C++ for 
the Macintosh. You don't have to be a 
programmer, or even know anything about 
programming to benefit from this book. 
Programming in Symantec C++ for the 
Macintosh covers everything from the 
basics to advanced features of Symantec 
C++. If you are a Think C or Zortech C++ 
programmer who wants to learn more 
about object-oriented programming or 
what's different about Symantec C++, 
there are chapters specifically for you. 
Includes helpful examples of C++ code 
that illustrate object-oriented programs. 
$20-05 $26.95 


Programming Primer For The 
Macintosh® Volume 1 by John 
Whittle and Judy May. This book provides 
an introduction to Macintosh 
programming, using C++ as the example 
language, and provides realistic, easy to 
follow, programming examples designed to 
work with either Symantec® C++ or 
Metrowerks® CodeWarrior”. Also includes 
one 3.5" disk with source code for the 
programming examples, along with 
numerous, useful, public domain utilities to 
use with each compiler. $8495 $34.15 
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Programming Starter Kit 

for Macintosh by Jim Trudeau 

is your road map to becoming a 
successful Macintosh progammer! This 
all-in-one kit contains everything you 
need to get started in the world of 
Programming for the Mac. Featuring 
valuable tools on the CD-ROM, this 
starter Kit teaches the basic skills and 
techniques necessary for successful 
program development. Begin your 
journey with the Programming Starter Kit 
for Macintosh. $45-08 $40.50 


QuickTime Starter Kit for 
Macintosh by Robert A. Lettieri & 
Judith Stern. This is the ultimate package 
for getting productive and having fun with 
Macintosh movie-making. Easy steps and 
valuable software help readers play, make, 
and edit QuickTime movies. CD-ROM 
includes QuickTime tools, movie clips, 
shareware, and demos of Premiere and 
other programs. Written by members of the 
respected Berkeley Macintosh User Group. 
Tips on the best ways to bring live-action 
video to Mac multimedia $45-08 $40.50 


Real World Apple Guide, For The 
Mac is the much anticipated help and 
navigational aid component of the new Apple 
system 7.5 OS. The book is a practical 
introduction to Apple Guide for programmers. 
It explains the design and function of Apple 
Guide, how to design your own guides using 
Apple Script. Comes with a disk of sample 
Apple Guides for Apple Guide-compliant 
applications. $39-95 $35.95. 


The ResEdit All Night Diner by 
David Ciskowski. An idea-filled menu and 
introduction to the joys of customizing 
software — and adding personality to the 
Mac with ResEdit! Shows readers how to 
Customize default icons, the text of menus 
and dialog boxes, cursors, pointers, and 
more. Provides specific recipes for doing 
Creative things with ResEdit — plus how to 
avoid problems. Disk features ResEdit 
program, plus lots of sample resources 
$2495 $22.45 


ResEdit™ Complete, Second 
Edition by Peter Alley and Carolyn 
Strange. With ResEdit, Macintosh 
programmers can customize every aspect 
of their interface form creating screen 
backgrounds and icons to customizing 
menus and dialog boxes. 608 pages. 
Book/disk package. $34.05 $31.45 


Sad Macs, Bombs, Disasters 
and What to Do About Them by 
Ted Landau comes to the rescue with your 
Macintosh problems. From fractious fonts 
to the ominous Sad Macintosh icon, this 
emergency handbook covers the whole 
range of Macintosh problems: symptoms, 
Causes, and what you can do to solve 
them. 640 Pages. $24.05 $22.45 
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Sex, Lies and Video 
Games by Bil! Hensler is writen Sp 
for the wannabe games writer locked 
inside every Mac programmer. This book 
provides a learn-by-example tutorial on 
the ins and outs of Mac arcade-style 
game programming in C. It teaches game 
theory, sprite animation, sound, and 
interaction techniques. This book is a 
must-read for serious programmer's and 
hobbyists alike. $31.46 


Software | Design: Creating 
User Friendly Software by Penny 
Bauersfeld (Series Editor: Tony Meadow). 
This excellent reference provides readers 
with a thorough how-to for designing 
software that is easy to learn, comfortable 
to operate and that inspires user 
confidence. Written from the perspective 
of Macintosh, but compatible with all 
platforms. Stresses user input from initial 
design, through prototyping, testing and 
revision. Provides tools for analyzing user 
needs and test responses. Includes 
exercises for sharpening user-oriented 
design skills. $20-05 $26.95 


Symantec C++ Programming for 
the Macintosh, Second Edition 
by Neil Rhodes & Julie McKeehan is the 
perfect introduction to C++ programming. 
$4608 $40.50 


3-D Starter Kit for Macintosh by 
Sean Wagstaff. The complete reference to 
3-D graphics on the Macintosh — ideal for 
beginning to intermediate product 
designers, illustrators, graphic designers, 
multimedia developers, animators, and 
video producers, as well as architects and 
engineers! Covers more than 50 major 
Macintosh 3-D imaging software 
packages — the most comprehensive book 
available. Lots of idea-packed examples 
that illustrate how 3-D products work — 
individually and together. CD-ROM 
includes sample models, image galleries, 
backgrounds, and textures, plus 3-D 
software tryout versions $40-08 $36.00 


Taligent’s Guide to Designin 
Programs: Well-Mannere 
Object-Oriented Design in C++ 
$49-80 $17.55 Call for more information. 


The Tao of AppleScript: BMUG’s 
Guide to Macintosh Scripting, 
Second Edition by Derrick Schneider & 
Hans Hansen. This updated bestseller is a 
complete, natural introduction to AppleScript 
programming essentials. Readers learn how 
to customize applications, automate tedious 
tasks, and create programs without having to 
use a complex programming language. 2 
disks contain AppleScript, QuickTime, Stuffit 
Lite, ResMover, and other helpful utilities. 
Progressive structure meets the needs of any 
Mac user, regardless of experience. 
Professional instructions are mixed with 
practical examples for easy learning $29-95 
$26.95 


Teach Yourself Mac C++ Pro- 
gramming in 21 Days by Namir 
Clement Shammas is the easy-to-follow 
21-day format teaches readers how to 
program in C++ using the Symantec C-++- 
compiler. $29-09 $26.99 


Tog on Software Design 

by Bruce Tognazzini. Respected 
industry futurist, Bruce “Tog” Tognazzini, 
presents his vision of our technological 
future, detailing the steps computer 
professionals need to take to deliver new 
technologies that will profit the industry 
and benefit society in general. This book 
contains Tog’s insights on a wide range 
of topics from quality management to the 
meaning of standards, and responses to 
queries supplied by designers and 
developers. $26.96 


Tricks of The Mac Game Pro- 
gramming Gurus See page 76 


The Underground Guide to Tele- 
commuting by Woody Leonhard, 
Addison Wesley. There’s no place like 
home. Especially when your boss, your 
kid, and the neighbor's dog are all barking 
for your attention simultaneously. Working 
away from a corporate office presents great 
(often unexpected) challenges and offers 
even greater rewards. Woody Leonhard 
takes on the toughest aspects of 
telecommuting and gives you the straight 
Scoop on how to make it work for you. 
Whether you’re a telecommuter, a 
telecommuter’s boss, or just curious, The 
Underground Guide to Telecommuting will 
give you the tools and information you 
need to turn electricity and a phone line 
into major productivity. $24.06 $22.45 


Visual Programming With 
Prograph CPX by Scott B. Steinman and 
Kevin G. Carver. This is the first book on 
Prograph CPX available through the book 
trade. It covers the only commercially 
supported visual programming language at a 
time when many programmers and 
managers, faced with continuing productivity 
problems, are searching for better 
programming environments. Prograph CPX 
is much more than such GUI-enhanced 
traditional languages as Visual Basic: It 
literally allows you to draw your program 
flow using icons and create a complete 
application without writing a line of code. 
This book is an introduction to the language 
and a guide for advanced users, for both 
Macintosh and Windows-based machines. 
Prograph is a fully pictorial, general-purpose, 
object-oriented language that speeds 
development with an integrated environment 
for design, coding, testing and debugging; 
with its OO framework for sophisticated GUI 
development; with its support for calls from 
C, C++, Pascal, and other routines; with its 
DAL, ORACLE, Sybase, AS/400 client/server 
DB support; and many other powerful 
features. $34.08 $30.60 


Web Head; The Mac Guide to 
the World Wide Web by Mary Jane 
Mara. Published by PeachPit Press. This 
is a beginning to intermediate book that 
shows you how to get the most from the 
Web, using plain talk that beginners will 
understand, and online veterans will 
appreciate. There is also instruction on 
how to build your own home page, posting 
pages on the Web, and avoiding common 
HTML mistakes. $2495 $22.45 


Webmaster Macintosh This book 
is a fast easy guide for turning your 
Macintosh into a World Wide Web site. 
With this book and the enclosed CD- 
ROM, you can create your own Web page 
in a matter of hours. $29-95 $26.95 


Web Weaving by Eric Tilton, 
Carl Steadman and Tyler Jones. ap 
Gives webmasters the guidance to create 
and maintain web sites that are easily 
navigated, scaleable, and maintainable. 
Covering the three major platforms for Web 
pages — UNIX, Windows, and the Mac — 
this book shows how to use software tools 
and utilities that are important in setting up 
web sites. Readers will learn how to install 
and configure Web servers, use authoring 
tools and converters, implement security 
schemes, and integrate multimedia features 
such as sound, video, and graphics. Most 
importantly, webmasters will learn how to 
best organize and present the information. 
This includes planning for growth, building 
in maintenance schemes, catering to users’ 
needs, and creating a navigable, logical 
underlying infrastructure. $24.95 $22.45 


Wireless For The 
Newton Software Devel- 
opment for Mobile 


Communications by Julie 
McKeehan and Neil Rhodes is a book 
that picks up where Programming for the 
Newton left off, teaching the reader how 
to develop Newton® software on the 
Macintosh. The enclosed floppy disk 
provides a sample application, as well as 
a fully functional demonstration version 
of Newton Toolkit” (NTK™), Apple 
Computer's complete development 
environment for the Newton®. Gives 
hands-on Newton environment training 
with sample code created specifically for 
the Newton®. The authors are external 
faculty at Apple Developer University 
teaching classes on programming for the 
Newton®. Programming experience is 
assumed, although not in any particular 
language. Enclosed is a floppy disk 
which contains source code for a Newton 
application, as well as demonstration 
NTK™. $384-95 $31.45 


Writing Localizable Software 
for the Macintosh by Daniel R. 
Carter. 469 pages. $26-95 $24.25 
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Advanced Color Imaging 
On the Mac OS explains nS ep 
you can augment the color support 
supplied with Quickdraw, and 
QuickdrawGX, using the Palette manager 
to provide the best set of colors on 
displays with limited color capabilities, 
soliciting the color choices from users 
with the color Picker Manager/ Using the 
ColorSync manager to match colors 
between screens and input and output 
devices such as scanners and printers/ 
learning how the color Manager assists 
Color QuickDraw in mapping an 
applications color requests to the actual 
colors available. $86-95 $33.25 


Apple Guide Complete by 
Apple Computer, Inc. For those ap 
who want the full power of Apple's 
complete toolset, this book and CD-ROM 
package from Apple provides everything 
you need to produce guide files 
successfully, including Guide Maker, the 
software you use to build and test guide 
files. You'll learn about the complete 
cycle of designing as well as advanced 
topics such as scripting and coding guide 
files. Book/CD-ROM, 544 pages. $39-06 
$35.96 


AppleScript Finder 
Guide, English Dialect, by 
Apple Computer, Inc. The 
AppleScript Finder Guide is 
an essential reference for anyone who 
wants to use AppleScript on a Mac to 
modify existing Finder scripts or to write 
new ones. The Finder scripting software 
allows you to write, record, or run scripts 
that trigger the same desktop actions that 
you trigger using the keyboard and 
mouse- actions such as opening and 
closing folders or manipulating files. This 
book introduces Finder scripting and 
describes how to record and modify 
simple scripts. In particular, it provides 
definitions for Finder object classes and 
commands. Use of this book requires that 
AppleScript be installed, and you should 
be familiar with AppleScript Scripting 
Additions Guide, and AppleScript 
Language Guide. $49-95 $17.95 





AppleScript Language 
Guide, by Apple Computer, 
Inc. The AppleScript Lang- 
uage Guide is the definitive 
description of the English dialect of the 
AppleScript scripting language. This 
book is an essential reference for anyone 
using AppleScript to modify existing 
scripts or to write new ones. It also 
contains useful information for 
programmers who are working on 
scriptable applications or complex 
scripts. This book begins with an 
introduction to scripting and an overview 
of AppleScript's main features. Most of 
the book consists of detailed definitions 
of AppleScript terminology and syntax in 
the following categories: Value classes, 





commands, objects and references to 
Objects, expressions, control statements, 
handlers, and script objects. In addition 
to definitions the book provides many 
sample scripts and discusses advanced 
topics such as writing command handlers 
for script applications, the scope of script 
variables and properties declared at 
different levels in a script, and inheritance 
and delegation among script objects. To 
get the most out of this book, you only 
need to be familiar with Macintosh 
computers. Although not required some 
previous experience with another 
scripting language (such as HyperTalk) is 
also helpful. $20-05 $26.95 


AppleScript Scripting 


Additions Guide, by 
Apple Computer, Inc. 
AppleScript Scripting 


Additions Guide is the definitive 
description of the scripting additions that 
accompany the English dialect of the 
AppleScript scripting language. Scripting 
additions are files that extend 
AppleScript's capabilities by providing 
the additional commands or coercions for 
use in scripts. This book is an essential 
reference for anyone using AppleScript to 
modify existing scripts or write new ones. 
It also contains information for 
programmers who want to write scripting 
additions. The Scripting Additions Guide 
is also a how to install any scripting 
additions and invoke their commands, to 
use the standard scripting additions 
commands, or to write scripting 
additions. 48-06 $17.05. 





HyperCard Stack Design Guide- 
lines by Apple Computer, Inc. is an 
essential book for everyone who creates 
Apple HyperCard stacks, from beginners 
to commercial developers. It covers the 
basic principles of design that, when 
incorporated, make HyperCard stacks 
effective and usable. Topics include 
guidelines, navigation, graphic design 
and screen illustration, text in stacks, 
music and sound, a sample stack 
development scenario, collaborative 
development, and the Stack Design 
Checklist. 240 pages. $2406 $19.95 


Inside AppleTalk by Gursharan S. 
Sidhu, Richard F. Andrews and Alan B. 
Oppenheimer. Apple Computer, Inc. 650 
pages. $84.06 $31.45 


Inside Macintosh®: AOCE 
Application Interfaces by Apple 
Computer, Inc. shows how your application 
can take advantage of the system software 
features provided by PowerTalk system 
software and the PowerShare collaboration 
servers. Nearly every Macintosh application 
program can benefit from the addition of 
some of these features. This book shows 
how you can add electronic mail capabilities 
to your application, write a messaging 
application or agent, store information in 
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and retrieve information from PowerShare 
and other AOCE catalogs, add catalog- 
browsing and find-in-catalog capabilities to 
your application, write templates that extend 
the Finder's ability to display information in 
PowerShare and other AOCE catalogs, add 
digital signatures to files or to any portion of 
a document, and establish an authenticated 
messaging connection. $40-46 $36.40 


Inside Macintosh®: AOCE 
Service Access Modules by Apple 
Computer, Inc. describes how to write a 
software module that gives users and 
PowerTalk-enabled applications access to 
a new or existing mail and messaging 
service or catalog service. This book 
shows how to write a catalog service 
access module (CSAM), a messaging 
service access module (MSAM), and 
AOCE templates that allow a user to set up 
a CSAM or MSAM and add addresses to 
mail and messages. $26-95 $24.25 


Inside Macintosh®: CD-ROM: Sce 
page 76 


Inside Macintosh®: Devices by 
Apple Computer, Inc. describes how to 
write software that interacts with built-in 
and peripheral hardware devices. With 
this book, you'll learn how to write and 
install your own device drivers, desk 
accessories, and Chooser extensions; 
communicate with device drivers using 
the Device Manager; access expansion 
cards using the Slot Manager; control 
SCSI devices using SCSI Manager 4.3 or 
the original SCS! Manager; communicate 
directly with Apple Desktop Bus devices; 
interact with the Power Manager in 
battery-powered Macintosh computers; 
and communicate with serial devices 
using the Serial Driver. $20-95 $26.95 


Inside Macintosh®: Files by Apple 
Computer, Inc. describes the parts of the 
operating system that allow you to manage 
files. It shows how your application can 
handle the commands typically found in a 
File menu. It also provides a reference to 
the File and Alias Managers, the Disk 
Initialization and Standard File Packages. 
510 pgs. $29-96 $26.95 


Inside Macintosh®: Imaging by 
Apple Computer, Inc. covers QuickDraw 
and Color QuickDraw. The book includes 
general discussions of drawing and 
working with color. It describes the 
structures that hold images and image 
information, and the routines that 
manipulate them. It also covers the 
Palette, Color, and Printing Managers, 
and the Color Picker, Color Matching, 
and Picture Utilities. $2605 $24.25 


Inside Macintosh®: Interap- 
plication Communication by Apple 
Computer, Inc. shows how applications 
can work together. How your application 
can share data, request information or 


services, allow the user to automate tasks, 
communicate with remote databases. 
$34-95 $31.45 


Inside Macintosh®: Macintosh 
Toolbox Essentials by Apple 
Computer, Inc. covers the heart of the 
Macintosh. The toolbox enables 
programmers to create applications 
consistent with the Macintosh “look and 
feel”. This book describes Toolbox 
routines and shows how to implement 
essential user interface elements, such as 
menus, windows, scroll bars, icons and 
dialog boxes. 880 pages. $8496 $31.45 


Inside Macintosh®: Memory by 
Apple Computer, Inc. describes the parts of 
the Macintosh operating system that allow 
you to manage memory. It provides detailed 
strategies for allocating and releasing 
memory, avoiding low-memory situations, 
reference to the Memory Manager, the 
Virtual Memory Manager, and memory- 
related utilities. 296 pages. $24.06 $22.45 


Inside Macintosh®: More Mac- 
intosh Toolbox by Apple Computer, 
Inc. covers other Macintosh features such 
as how to support copy and paste, 
provide Balloon Help, play and record 
sound and create control panels are 
covered in this volume. The managers 
discussed include Help, List, Resource, 
Scrap and Sound. $34-66 $31.45 


Inside Macintosh®: Networking 
by Apple Computer, Inc. describes how to 
write software that uses AppleTalk 
networking protocols. It describes the 
components and organization of 
AppleTalk and how to select an AppleTalk 
protocol. It provides the complete 
application interfaces to all AppleTalk 
protocols, including ATP (AppleTalk 
Transaction Protocol), DDP (Datagram 
Delivery Protocol), and ADSP (AppleTalk 
Data Stream Protocol), among others. 
$20-95 $26.95 


Inside Macintosh®: Operating 
System Utilities by Apple Computer, 
Inc. describes parts of the Macintosh 
Operating System that allow you to manage 
various low-level aspects of the operating 
system. Everyone who programs the 
Macintosh should read this book! It will 
show you in detail how to get information 
about the operating system, manage 
operating system queues, handle dates and 
times, control the settings of the parameter 
RAM, manipulate the trap dispatch table, 
and receive and respond to low-level 
system errors. $26-05 $23.45 


Inside Macintosh®: Overview by 
Apple Computer, Inc. is the first book that 
people who are unfamiliar with Macintosh 
programming should read. It gives an 
overview of Macintosh programming 
fundamentals and a road map to the New 
Inside Macintosh library. Inside 
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Macintosh: Overview also covers various 
programming tools and languages, 
compatibility guidelines and an overview 
of considerations for worldwide 
development. 176 pages. $2495 $20.65 


Inside Macintosh®: PowerPC 
Numerics by Apple Computer, Inc. 
describes the floating-point numerics 
environment provided with the first release 
of PowerPC processor-based Macintosh 
computers. The numerics environment 
conforms to the IEEE standard 754 for 
binary floating-point arithmetic. This book 
provides a description of that standard 
and shows how RISC Numerics compiles 
with it. This book also shows 
programmers how to create floating-point 
values and how to perform operations on 
floating-point values in high-level 
languages such as C and in PowerPC 
assembly language. $28-95 $26.00 


Inside Macintosh®: PowerPC 
System Software by Apple 
Computer, Inc. describes the new process 
execution environment and system 
Software services provided with the first 
version of the system software for 
Macintosh on PowerPC computers. It 
contains information you need to know to 
write applications and other software that 
Can run on the PowerPC. PowerPC 
system Software shows in detail how to 
make your software compatible with the 
new run-time environment provided on 
PowerPC-based Macintosh computers. It 
alsO provides a complete technical 
reference for the Mixed Mode Manager, 
the Code Fragment Manager, and the 
Exception Manager. $2495 $22.45 


Inside Macintosh®: Processes 
by Apple Computer, Inc. describes the 
parts of the Macintosh operating system 
that allow you to control the execution of 
processes and interrupt tasks. It shows in 
detail how you can use the Process 
Manager to get information about 
processes loaded in memory. It is also a 
reference for the Vertical Retrace, Time, 
Notification, Deferred Task, and Shutdown 
Managers. 208 pages. $2205 $20.65 


Inside Macintosh®: QuickDraw™ 
GX Environment and Utilities — 
A companion to QuickDraw™ GX Objects, 
this book contains programming 
information useful to any developer 
writing QuickDraw GX applications. It 
describes QuickDraw GX memory 
management, error handling, debugging, 
and mathematical functions, as well as 
conversion from QuickDraw to QuickDraw 
GX. $29-05 $26.95 


Inside Macintosh®: QuickDraw” 


GX Graphics by Apple Computer, Inc. 
Shows readers how to create and 
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manipulate the fundamental geometric 
shapes of QuickDraw GX to generate a 
vast range of graphic entities. It also 
demonstrates how to work with bitmaps 
and pictures, and specialized QuickDraw 
GX graphic shapes. $26-05 $24.25 


Inside Macintosh®: QuickDraw™ 
GX Library by Apple Computer, Inc. is 
the powerful new graphics architecture for 
the Macintosh. Far more than just a 
revision of QuickDraw, QuickDraw GX is a 
unified approach to graphics and 
typography that gives programmers 
unprecedented flexibility and power in 
drawing and printing all kinds of shapes, 
images, and text. 


Inside Macintosh®: QuickDraw™ 
GX Objects by Apple Computer, Inc. 
introduces QuickDraw GX and its object 
structure, and shows programmers how 
to manipulate objects in all types of 
programs. $26-05 $24.25 


Inside Macintosh®: QuickDraw” 
GX Printing This book is essential for 
any developer whose QuickDraw™ GX 
application supports printing. It shows 
how to support the new printing features 
of QuickDraw GX, including desktop 
printers and expandable printing dialog 
boxes. QuickDraw GX Printing also 
shows how to use printing-related objects 
to add custom panels to printing dialog 
boxes and to create custom page formats. 


$2695 $24.25 


Inside Macintosh®: QuickDraw™ 
GX Printing Extensions and 
Drivers — Any developer who wants to 
create extensions to the application 
printing capabilities of QuickDraw™ GX, or 
who needs to write a printing device 
driver that works with QuickDraw GX 
needs this book. QuickDraw GX Printing 
Extensions and Drivers describes how to 
Create printing extensions and printer 
drivers, and provides a complete 
reference to the messages, functions, and 
resources that they use. $20-05 $26.95 


Inside Macintosh®: QuickDraw™ 
GX Programmer’s Overview - 
This book provides an introduction to 
QuickDraw™ GX, providing an overview of 
the QuickDraw GX environment from a 
developer's perspective. It introduces the 
QuickDraw™ GX programming and 
runtime environments, the relationship 
between QuickDraw GX and the rest of the 
Macintosh® systems software and the 
relationship between QuickDraw GX and 
Macintosh applications. The key elements 
of QuickDraw GX programming, data 
Structures, object types, and functions 
used most frequently by QuickDraw GX 
developers are also covered. After a 
general introduction, this book provides 





readers with a series of practical 
examples demonstrating how to approach 
programming with QuickDraw GX. 
$2405 $22.45 


Inside Macintosh®: QuickDraw™ 
GX Typography — This book is 
essential for any developer who uses 
QuickDraw™ GX to manipulate text. It 
shows how to use QuickDraw GX objects 
to handle all kinds of text — from plain, 
unstyled text to complex, mixed-direction 
and multi-language text with 
sophisticated stylistic and typographic 
variations. QuickDraw GX Typography 
shows how to create and manipulate the 
three different types of text shapes 
supported by QuickDraw GX including 
text shapes, glyph shapes, and layout 
shapes. $20-05 $26.95 


Inside Macintosh®: QuickTime 
by Apple Computer, Inc. is for anyone 
who wants to create applications that use 
QuickTime, the system software that 
allows the integration of video, animation, 
and sounds into applications. This book 
describes all of the QuickTime Toolbox 
utilities. In addition, it provides the 
information you need to compress and 
decompress images and image 
sequences. $20-08 $26.95 


Inside Macintosh®: QuickTime 
Components by Apple Computer, 
Inc.covers how to use and develop 
QuickTime components such as image 


compressors, movie controllers, 
Sequence grabbers, and video digitizers. 
$34.05 $31.45 


Inside Macintosh®: Sound by 
Apple Computer, Inc. describes the parts 
of the Macintosh system software that 
allow you to manage sounds. It contains 
information that you need to know to write 
applications and other software that can 
record and play back sounds, compress 
and expand audio data, convert text to 
speech, and perform other similar 
Operations. $26-95 $24.25 


Inside Macintosh®: Text by Apple 
Computer, Inc. describes how to perform 
text handling, from simple character 
display to multi-language processing. The 
Font, Script, Text Services, and Dictionary 
Managers are all covered, in addition to 
QuickDraw Text, TextEdit, and International 
and Keyboard Resources. $39-95 $35.95 


Inside Macintosh®: X-Ref by 
Apple Computer, Inc. is a fast access to 
all the information in Inside Macintosh. 
Inside Macintosh X Ref; Provides 
programmers with a quick and easy way 
to find the exact information they need in 
this definitive suite of books, (all 26 
volumes). It is indexed by topic, volume, 








chapter, and accompanying page number. 
$40-05 $17.95. 


Inside the Macintosh Com- 
munications ToolBox by Apple 
Computer. This book is the definitive 
reference to the Macintosh Commun- 
ications Toolbox, an integral part of the 
system 7 Macintosh Toolbox that 
enables developers to create 
communications applications or add 
communications features to other 
applications.This book describes all of 
the routines that provide programmers 
with standard access to important 
Communications services and in 
addition enables programmers to extend 
the reach of the Macintosh into non- 
Apple environments. $2405 $22.45. 


Macintosh Programmer’s Tool- 
box Assistant CD-ROM: See page 77 


OpenDoc Programmer’s 
Cookbook for the Mac 0S 

by Apple Computer Inc. Designed as a 
companion to OpenDoc Programmer's 
Guide to the Mac OS. This book provides 
the authoritative hands-on guide to 
implementing OpenDoc. The Reader gets 
practical advise and tutorials on how to 
create OpenDoc component programs 
with descriptions of all the code on CD- 
ROM accompanying the Programmer's 
Guide. Programmer’s can study the 
complete, tested code in the Cookbook, 
then rewrite and reuse portions of the 
code in their own component programs. 
$2495 $22.45 


OpenDoc Programmer’s Guide 
by Apple Computer, Inc. This is the 
Official reference for the implementation 
of OpenDoc on the Mac OS. The book 
describes the component software 
revolution and explains how to develop 
for it on the Mac OS platform. An 
accompanying CD-ROM contains a 
complete reference to the OpenDoc 
programming interface, and an extensive 
collection of tested, reusable sample 
code. $40.46 


3D Graphics Program- 

ming Using QuickDraw 3D 

by Apple Computer, Inc. Now you can 
incorporate spectacular 3D graphics into 
your applications. This book/CD-ROM 
package explores QuickDraw 3D, a 
graphics extension to the Mac OS for 
Power Macintoshes. The CD contains the 
complete QuickDraw 3D system itself and 
a complete database of the QuickDraw 3D 
API, allowing you instant access to the 
hundreds of graphics calls via a fast 
viewing engine. Book/CD-ROM, 640 
pages. $89-05 $35.96 
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BASIC for the Newton is 
metisa BASIC for the Newton! From 

mame \S BASIC Corporation, it is a 
wSBAsic fully interactive implementation 
of the BASIC programming language. It 
runs entirely on the Newton — no host is 
required. It includes a full set of functions 
and data types, hand-written input, 
windows, buttons and extensions to take 
advantage of the Newton environment. 
Applications can create files or access the 
built-in soups. Applications can also 
access the serial port for input and 
output. Work directly on the Newton, or 
through a connected Mac/PC and 
keyboard. NS BASIC includes a 240 page 
pocket sized manual. Runs on all Newton 
1.x and 2.0 units. $99 


BBEdit 3.1: See page 75 
CodeManager™ See page 75 


CMaster 2.0 by Jersey Scientific 
installs into THINK C 5/6/ 7 and 
Symantec C++ for Macintosh, and 
enhances the editor. Use its function popup 
to select a function and CMaster takes you 
right to it. Other features include multiple 
clipboards and markers, a Function 
Prototyper, and a GoBack Menu which can 
take you back to previous editing contexts. 
Almost all features bindable to the 
keyboard, along over a hundred keyboard- 
only features like “Add New Automatic 
Variable.” Glossaries, AppleScript and 
ToolServer support, Macros, and External 
Tools you create too! $129.95 


CodeWarrior 8 Gold: See page 75 
CodeWarrior 8 Bronze: See page 75 


Discover Programming for 
Macintosh: See page 75 





Inside CodeWarrior 8 and Inside 
PowerPlant: See page 76 


LPA MacProlog comprises a 
Edinburgh syntax Prolog compiler system 
Set in an attractive multi-window 
development environment with an 
integrated program editor, graphical call- 
graph facilities and an interactive source- 
level debugger. LPA MacProlog features 
high-level access to the Macintosh 
ToolBox for using graphics, dialogs, 
windows, icons, resources in a simple 
and versatile way LPA MacProlog also 
includes interfaces to C and Pascal code 
resources. The MacProlog Run-time 
Generator enables the production of 
double-clickable distributable applica- 
tions. The compact run-time system 
Supports first argument indexing, tail- 
recursion and last-call optimization. 
Optional add-ons tools include flex, 
Prolog++, MacDBI for Oracle and the 
MacProlog Dialog Editor. Programmer 
Edition $745; Developer Edition (which 
includes the run-time generator and 
distribution license) $1500 


QLS Object Pascal CD includes the 
world’s first Object Pascal compiler for 
Power Macintosh. 100% compatible with 
Apple's MPW Pascal, LS Object Pascal 
combines the best of Apple's native 
development tools with innovative new 
technology developed at Language 
Systems. Compiler options specify 68K 
or native PowerPC code generation. 
Included on the CD are: LS Object Pascal 
compiler, Universal Pascal Toolbox 
interfaces, fully loaded MPW 3.3.1, 68K 
and PowerPC source debuggers, 
PowerPC assembler, online 
documentation, Macintosh Tech Notes, 
and a special version of AppMaker by 
Bowers Development that generates 


outdated {documents jorg: 


native Pascal source code. The beta 
release includes upgrades to v1.0 when it 
becomes available. $399 


Roaster DR2™ See page 76 


| SmalitalkAgents® 
i “ie (STA) is a sophisticated 

application development 
sivironiiert featuring a new generation of 
the Smalltalk language, QKS Smalltalk™. 
Productivity is no longer measured in 
lines of code, but in project completion 
time. STA allows “live” direct 
manipulation of your objects. The 
development process is dynamic, 
interactive and iterative. Just like C/C++ 
and Assembly, STA provides easy and full 
access to the features of the MacOS™ and 
Mac Toolbox. You can link your non- 
Smalltalk code resources using our 
External Code Linking Toolkit™ (ECLT). 
You can also call back into STA from 
foreign functions written in C/C++, Pascal, 
FORTRAN, and Assembly. STA’s 
automatic garbage collection and object- 
based typing will free you from tedious 
memory management and bookkeeping 
chores. A sophisticated database for 
source code management provides an 
almost infinite variety of ways to cross- 
reference, access, view, and manipulate 
your code and objects. STA includes an 
Application Delivery Toolkit™ (ADT) that 
allows you to create royalty-free, stand- 
alone, double-clickable applications in 
just a matter of minutes. The foundation of 
the QKS Product Family, the Agents 
Object System (AO/S), is an underlying 
task framework, housing components and 
services that Save you years of work. Any 
component built in AO/S will function as 
an OpenDoc component or container and 
components from non-AQ/S sources can 
be seamlessly integrated into the AO/S 





SOFTWARE ENGINEERING 


MacA&D by Excel Software combines the capabilities of aid vest eee Voodoo is a version control tool 


MacAnalyst/Expert and MacDesigner/Expert into a single 
application. It supports structured analysis and design, object- 
oriented analysis and design, real-time extensions, task design, 
data modeling, screen prototyping, code editing and browsing, 
reengineering, requirement traceability, and a global data 
dictionary. Demo $149, Product $2995 


MacAnalyst/Expert, Demo $79, Product $1595 MacAnalyst 
Demo $79, Product $995 MacDesigner/Expert, Demo $79, 
Product $1595. MacDesigner Demo $79, Product $995. By Excel 
Software. Available. Call for more information about these 
products. 


MacDesigner/Expert by Excel Software supports software 
engineering methods with the capabilities of MacDesigner plus 
multi-task design. An integrated requirement database provides 
traceability from requirement statements to design diagrams, code 
or test procedures. This tool is well suited to design or 
maintenance of real-time, multi-tasking software projects. Demo 
$79, Product $1595. MacDesigner Demo $79, Product $995. 
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VOODOO for the simple and clear manage- 
ment of projects in which files are 
created in numerous versions 
(variants and revisions). Voodoo allows both variant and revision 
control, and it manages not only variants and revisions of single 
files, but of a whole software project (multi files, multi users, multi 
variants, access rights, ...). The tool offers a neat graphical user 
interface and is not only suitable for mere source code control but 
can handle all different kinds of files with amazing compression 
rates: typical size of delta between arbitrary files 5% (in words: 
five per cent) |!!! no matter whether the files are plain text or any 
other documents — e.g., MSWord, 4D, Canvas, FileMaker ... 
Please note special prices for multiple copies: single 
license $190: 2 pack $300; 5 pack $665; 10 pack 
$1140; 20 pack $2000. Add’l pricing available on 

request. 


VOODOO v 1.7 See page 77 


system. SmalltalkAgents List Price: $695. 
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Symantec C++ See page 77 


THINK Pascal v. 4.0 by Symantec 
Corporation. Professionals and students 
will welcome this version of THINK Pascal. 
It is fully integrated for rapid turnaround 
time and lets you take advantage of System 
7 capabilities. Features include support for 
large projects, enhanced THINK Class 
Library, System 7 compatibility, superior 
code generation, and smart linking. Product 
Contents: Four Macintosh disks, a 562- 
page user manual, and a 498-page object- 
oriented programming manual. $169 


UED/M 2.7 by Nisus Software, is a 
programmer's text editor which has defined 
the industry standard for speed and 
efficiency. With integrated support for 
Symantec C/C++, Metrowerks 
CodeWarrior 6, and MPW, QUED/M offers 
unrivaled usefulness for the Macintosh 
developer. In addition to supporting all the 
major development environments on the 
Macintosh, QUED/M offers dozens of 
powerful editing features, including 
unlimited undo and redo, UNIX style GREP 
searching, macro language, scripting, text 
folding, text sorting, file comparison and 
merging, Toolbox lookup, ten 
editable/appendable clipboards, line 
numbering, markers, displaying text as 
ASCII codes, vertical and horizontal screen 
splitting, plus much more. $149 


INSTALLER 


paele] B 





InstallerPack™ by StepUp Software is 
a package of several Installer “atoms” that 
let developers incorporate graphics, 
sounds, file compression and custom 
folder icons into installation scripts. 
Compression formats supported are 
Compact Pro & Diamond. Each atom also 
available separately. Compression requires 
additional licensing. $219 


ScriptGen Pro™ by StepUp Software is 
an Installer script generator which requires 
no programming or knowledge of Rez. 
Supports StepUp’s InstallerPack, Stufflt 
compression, custom packages, splash 
screens, network installs, Rez code output, 
importing resources, and AppleEvent link 
w/MPW: $169 
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Animation Class Library version 
2.0 (ACL2.0) is an advanced object- 
Oriented multimedia framework, allowing 
fast development of high-quality interactive 
applications. Main features of ACL2.0 are: 
Powerful animation engine which supports 
structured sprites, collision detection at pixel 
precision, sprites sorting, powerful blitter 
and vector objects. Scrolling of background 
picture in circular buffer and tile- 
mapscrolling. Application framework for 
building standard and 3D controls, 
panes,menus, full screen displays, windows, 
etc. Quicktime and multi-channel sound 
support. >800 functions and >100'000 lines. 
Complete C++ source code for CodeWarrior 
and Symantec C++, examples, 
documentation and technical support. $250 


AppMaker makes it faster and easier 
todevelop the user interface for a 
Macintosh application. Just point and click 
to design your application, then AppMaker 
creates resources and generates excellent 
source code. AppMaker supports most 
development environments including 
Metrowerks, Symantec, or MPW; C, C+, 
or Pascal; procedural or object-oriented, 
using PowerPlant, TCL, or MacApp. The 
generated code uses the Universal Headers 
to provide PowerMac compatibility. 
Beginners use AppMaker to learn object- 
Oriented and Macintosh Toolbox 
programming techniques. Experts use it to 
increase productivity. It saves so much 
time it's like having your own assistant 
programmer working for you. Includes 
one-year subscription on CD. $299 


B-Tree HELPER” 2.2 is an inexpensive 
database engine for Macintosh 
Programmers in C source code. B-Tree 
HELPER gets space in a file in contiguous 
fixed length blocks. It expands the file as 
necessary and contracts files when possible. 
B-Tree HELPER inserts and deletes keys in 
one or more B-Trees. It finds keys equal to, 
less than, or greater than a given value in a 
few hundredths of a second. It finds lists of 
records whose keys are equal to, less than, 
Or greater than a given value or are ina 
range of values. $150 


PROFILERS/DEBUGGERS 


dtF is a true relational database system 
for Apple Macintosh computers. dtF 
provides a powerful choice for developers 
who want to create database centered 
applications with no performance trade- 
offs. dtF features SQL, full transaction 
control, error recovery, single user, client 
server architecture and multi-platform 
Support including DOS, Windows, 0S/2 
and UNIX. The C/C++ API is identical and 
fully portable cross all supported 
platforms. Third-party vendors supporting 
dtF will be able to offer a variety of 
advanced features and benefits to their 
customers royalty free. Tools are included 
for importing, exporting, creating and 
managing databases and _ users. 
Supported development environments 
include: Symantec, MPW, Metrowerks 
and more. Mac/SDK $695 


MacWireFrame by 
Amplified Intelligence. 
Create your own virtual 
reality application with 


MacWireFrame, a virtual reality 
application frame work. Includes a 
complete library of object oriented 
graphics routines, its own easy to 
understand application frame work 
(similar to MacApp or TCL but a lot easier 
to understand), plus an example 
application program that lets you start 
solid modeling right away. Comes 
complete with fully documented source 
code. All new purchases will be 
guaranteed a $49.99 upgrade to the soon 
to be released, scriptable, MacWireFrame 
5.0. Due to the overwhelming response 
the special price offer has been extended 
for a little while longer. Special Offer: 
$209-00 $75!!!! 


OOFILE See page 76 
PictureCDEF 


1.3 by Paradigm 
Software iS a 


professional-level CDEF for 
creating custom graphical 
Whe (8-64 pixels). 
PictureCDEF is used in 


products by Adobe, ProVue, STF Tech- 





LIBRARIES/FRAMEWORKS/DATABASES 


nologies and others. It is multi-monitor 
and bit-depth sensitive. The button 
graphic (cicn, ResEdit) can be changed at 
runtime and even animated with a call- 
back routine. Create distinct buttons in 
seven variations: MultiState, PushButton, 
FlexiButton, ToggleButton, ChkButton, 
PushPictButton and TogglePictButton. 
Position the optional button title at left, 
bottom or right, or follow the system text 
direction for international support. 
Manual, sample code and MacApp 3.0 
support included. Full source code: 
$95.00 Object code: $45.00. 


PowerTap”™ See page 76 


Q3S/3dPane/SmartPane source 
code bundle by Vivistar Consulting. Q3S: 
source code bundle from ViviStar 
Consulting. Full featured 3d graphics. 
Points; lines; polygons; polyhedra: 
Gouraud shading; z-buffering; culling; 
depth cueing; parallel, perspective, and 
Stereoscopic projections; performance 
enhancing “OnlyQD" and "Wireframe’ 
modes; full clipping; pipeline access; 
animation and model interaction support: 
and a ‘triad mouse" to map 2d mouse 
movement to 3d. 83dPane provides 
integration with the TCL and provides a 
view orientation controller. SmartPane 
provides TCL offscreen image buffering, 
flicker free animation, and QuickTime 
movie recording. SmartPane functions in 
3d or 2d scenarios. All work with C++ 
compilers or ThinkC 6 and compile to 
PowerPC or 68K target machines. $192 


Spellswell 7 1.0.4 is an award- 
winning, comprehensive, practical spelling 
checker that works in batch mode or within 
applications that incorporate the Apple 
Events Word Services protocol (e.g., 
Eudora, WordPerfect, Communicate!, and 
Fair Witness). Spellswell 7 checks for 
spelling errors as well as common typos 
like capitalization errors, spaces before 
punctuation, double double word errors, 
abbreviation errors, mixed case errors, 
extra spaces between words, a/an before 
vowel/consonant, etc... MacTech orders 
include developer kit with Writeswell Jr., a 






sample Apple Events Word Services word- 
processor and its source code. $74.95 
StoneTable: A library replacing all 
functions found in list manager plus: 
variable size columns/rows; different font, 
size, Style, forecolor, backcolor per cell: 
sort, resize, move, copy, hide 
columns/rows; edit cells/titles in place; 
titles for columns/rows; multiple lines per 
Cell; grid line pattern/color; greater than 
32k data per table; up to 32k text per cell: 
support for balloon help and binary cell 
data. Versions for Think C, Think Pascal, 
MPW C, MPW Pascal, CodeWarrior 6 C. 
(all prices per developer) $150 first 
compiler, additional compilers $50. 


StoneTable and StoneTable- 
Extra for PowerPC: Same function- 
ality as 68K libraries. Versions for MPW 
C and CodeWarrior 6 C. Must have 68K 
libraries. (all prices per developer) 
StoneTable $100, StoneTableExtra $25. 


StoneTable Extra: Additional 
functions for StoneTable. Drag selected cells 
within table or to other tables; optionally add 
rows as part of drag; popup menus or check 
boxes in cells; variable width grid lines: 
move/drag/resize table in window; clipboard 
operations on multiple cells. Requires 
StoneTable. (all prices per developer) $50 
first compiler, additional compilers $25. 


3D Game Machine v1.2 by 
Virtually Unlimited is a C library for 
creating lightning-fast 3D arcade games 
and interactive multimedia applications. 
3DGM has a simple easy-to-use interface 
and features very fast rendering (15 
frames per second on a 14" monitor 
completely texture-mapped, with a 
PowerMac 6100/60), full "virtual" 3D 
worlds with six degrees of freedom, free- 
form texture mapping, shading, material 
and light properties, convex/cave 
polygons with unlimited vertices, 
unlimited light sources, dynamic hidden 
surface removal, special graphic modes 
for fast full-screen animation, collision 
detection, explosion simulation, 3D data 
importing. Runs on all Macs! Works with 
CodeWarrior. $299 + license. 


Last Resort Programmer’s Edition records 
every keystroke, command key and mouse event (in local 
coordinates) to a file on your hard disk. This is especially 
useful for program testing & debugging, and for technical 
Support and help desks. If something goes wrong 
(because of a power failure, system crash, forgetting to 
save or deleting lines) and you lose a word, phrase, or 
document you can look in the Last Resort keystroke file 
and recover what you typed. Last Resort is also useful for 
technical support personnel, when they have to ask “What 
was the last thing you did before...?” $74.95 


LJ Profiler by Lars Jordebo Datakonsult supports profiling 
of C++ 68K and PowerPC applications compiled with 
CodeWarrior 6, CFront or Symantec C++. Based on active 
profiling, i.6. profiling code called at function enter and exit, 
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the browser application lets you follow call chain timings in 
hierarchical views or separate windows. Collect, organize, 
compare and save profiling data from different versions of 
your application into a project. Scriptable and recordable with 
full access to most internal data structures. Optional remote 
profiling and tracking of segment and stack usage. Full source 
code to what you link into your application. $295. 


The Memory Mine™ by Adianta is a stand alone 
debugging tool for Macintosh and native PowerPC. 
Programmers can monitor heaps, identify problems such 
as memory leaks, and stress test appli-cations. Active 
Status of memory in a heap is sampled on the fly: allocation 
in non-relocatable (Ptr), relocatable (Han-dle) and free 
space is shown, as are heap corruption, fragmentation, and 
more... Allocate, Purge, Compact, and Zap memory let 


users stress test all or part of a program. Source code is not 
needed to view heaps. It works on Macintoshes with 68020 
or later and System 7.0 or later. $99 


QC™ by Onyx Technology. See page 76 


Spyer by InCider is a simple operated tool that records 
all actions (including mouse movement) you perform on a 
Macintosh computer and then replays them at your 
preferred speed. The recorded data can be saved in files 
for future use. Spyer works as a background process with 
any Macintosh application and is triggered by user 
defined Hot Keys. Spyer enables the “Continuous Redo” 
utility and is especially useful for software testing and 
demonstration. $39 
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SCRIPTING/SYSTEM ADMINISTRATION 





CLimate by Orchard Software is a command line 
interface that lets you communicate with your Macintosh 
using English commands to create, delete, rename, and 
move files and folders. It can start applications, format 
disks, restart your computer, etc. CLImate supplements 
the Finder. It includes a BASIC interpreter that lets you 
script your Macintosh without AppleScript. The interpreter 
includes advanced programming constructs: repeat loops, 
if/then/else conditionals, subroutine calls, etc... CLimate 
implements wildcard characters, enabling you to work on 
groups of files. Use CLImate instead of MPW to manage 
your projects. CLImate is an application occupying 70K 
disk space. It comes bundled with sample programs and 
full documentation. $59.95 


Cron Manager by Orchard Software implements the 
UNIX Cron facility. It can open any Macintosh file on a 
given date and time. By creating an alias, renaming it to 
the date and time to open, and moving it into the special 
Cron Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creates the special Cron 
Events Folder inside your System Folder. It is completely 
transparent to the user. It works like the Startup Items 
folder, only smarter. It works with any Macintosh file: if 
you can double-click to start it, Cron Manager can open 
it. $26.95. Cron Manager bundled with CLImate, $59.95. 


DataScript DataScript is probably the quickest, 
easiest and most cost-effective way to make your 
integrated AppleScript solutions database aware-today. 
Quickest: It takes just six lines of AppleScript to make 
new or existing scripted solutions database aware, and 
fetch data from RDBM's such as Oracle, Sybase, DB2, or 
Informix. Easiest: DataScript's scripting terminology is 
easy to learn, easy to use, and easy to remember. “Inside 
DataScript" contains lots of easy to follow scripts to reuse 
in your own solution. Cost Effective: Because 
DataScript is so easy to learn, and use you'll become 
productive very quickly, and once you're ready to ship, 
you'll find our licensing schemes very attractive. $249.00 


FaceSpan™ v2: See page 75 


Rosanne™ Rosanne is a collection of utilities which 


offer the user complete contro! over raw data. Users can 
sort files, extract selected records, summarize frequency 
counts, create sample files, perform matching on multiple 
files, and reformat data to new specifications, all on the 
desktop, and even on files of a million records or more. 
The Rosanne Utilities also support AppleScript™, 
enabling the user to link several actions together to 
complete an entire process. The Rosanne Utilities are 
recordable; users may perform a series of actions, and 
using an AppleScript editor such as Scripter™, see their 
actions translated directly into AppleScript commands. All 
of the utilities support multi-tasking and background 
processing. The Rosanne Utilities will assist you in 
picking your specifications, determining record length, 
creating output files and managing the storage of data. 
Rosanne Utilities: Copy — duplicates an input file. 
Format — creates an altered version of an input file, 
containing either subsets of the fields on the input file, or 
new fields. Select — creates a subset of the records on an 
input file based on some selection criteria. The Recode 
option allows the user to group data, or correct coding 
entries. Sort — orders an input file by a particular field or 
set of fields. Match — joins together two input files based 
on common values occurring in corresponding fields or 
sets of fields. Aggregate — creates an output file with 
summary levels. $595 


ScriptBase™ The Scripting Database is a 
database for storing persistent objects to be made 
available for access to AppleScript, Apple’s system-level 
user scripting language for controlling applications on 
Macintosh® computers. Once installed, the database 
becomes part of the AppleScript system, adding a host of 
commands to the basic AppleScript vocabulary. 
Retrieving the objects is simple using AppleScripts 
natural-language syntax and structure. Objects stored and 
retrieved in ScriptBase can be accessible any time from 
any script on the user's computer. These objects can be of 
any type, including numbers, character strings, lists, 
records, scripts, and references to disks, files, folders, as 
well as abstract raw data, to name just a few. ScriptBase 
can be used to maintain system-wide settings, such as 
sets of preferences, paths to frequently-used files or 
folders. Complex installations can be made easier by 


Organizing data and scripts within the database's 
structure. $79 


Script Debugger by Late Night Software 
Ltd. is a powerful and flexible AppleScript 
authoring tool. Script Debugger makes it 
simple for novice and experienced script 
writers to get the most from AppleScript. The program's 
advanced debugging environment offers single-step script 
execution with breakpoints. The Script Debugger 
dictionary browser features a graphical view of objects 
provided by scriptable applications. With the program, 
you also receive the Late Night Software Scripting 
Additions, a collection of more than 70 new AppleScript 
commands, and Scheduler, a utility that allows you to 
launch scripts at pre-determined times. $129 





Scripter®: See page 76 
ScriptWizard™ See page 77 


TCP/IP Scripting Addition” is the 
latest version of an award-winning 
AppleScript scripting addition (first place in 
the 1994 “Best Hack” category in the 
Everyday AppleScript” Programming Competition). This 
scripting addition (or osax) allows you to write scripts 
using MacTCP™ commands in AppleScript”. Potential 
uses of this include sending e-mail or files through a 
script, checking if users are logged on (via Finger), 
automating FTP, Gopher, NetNews, Telnet, and LPR, 
verifying links in HTML documents, and quickly writing 
many other TCP/IP client-server programs. Sample 
scripts are included already implementing many of these 
functions. When combined with FaceSpan, the potential 
for rapid implementation of Internet client-server 
applications is enormous. The TCP/IP Scripting Addition 
works with AppleScript 1.0 or later and MacTCP 2.0.4 or 
later. It is compatible with Open Transport™. The TCP/IP 
Scripting Addition can be used from Script Editor, 
HyperCard 2.2, MacPERL, FaceSpan and other Open 
Scripting Architecture applications. See “http:// 
www.mangotree.com/biz/mango/index.html” for more 
details. $49 





ICONIX POWER TOOLS 


ICONIX PowerTools consist of ten 
modules that can be used either as 
Stand-alones or combined to form a 
custom, integrated development 
environment: 


AdaFlow supports Ada-oriented 
design and Ada development using 
— Buhr/Booch style diagrams and Module 
Architecture Diagrams for Booch OOD, 
an integrated Dictionary, and a Language 
Sensitive Editor for C++ and Ada. 


ASCII Bridge enables PowerTools 
repository information to be merged, 
imported, and exported in ASCII or CDIF 
format and provides an Interleaf interface. 


-DataModeler supports Chen, 
Martin, and IDEF1X Data Modeling and 
for Shlaer/Mellor object-oriented 
analysis and includes an Entity 
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Relationship Attribute (ERA) Diagram 
Editor, Data Dictionary, and Language 
Sensitive Editor. 


FastTask provides real-time 
extensions (Ward-Mellor, Hatley) in the 
form of State Transition Diagrams and 
their equivalent matrix representations, 
supports Jacobson Interaction 
Diagrams and  Shliaer/Mellor, 
Rumbaugh, Coad/Yourdon, and Booch 
object-oriented methods; includes 
multi-userdictionary, and language 
sensitive editors. 


FreeFlow provides support for 
DeMarco Structured Analysis with real- 
time extensions (Data and Control Flow 
Diagrams, Data Dictionary, Minispecs, 
Consistency Checking) and several 
object-oriented methods. 


CoCoPro implements Boehm's 
Constructive Cost Model (CoCoMo) 
technique for estimating costs of 


software projects. It supports the 
intermediate CoCoMo model, and 
allows automatic calibration of the 
model to a cost history database. 


ObjectModeler supports the object- 
oriented methods of Rumbaugh, 
Coad/Yourdon, Booch and Jacobson 
with four graphical editors, includes 
Dictionary, and provides Language 
Sensitive Editors for OOP including C++, 
Smalltalk and other languages, template 
development, and pseudocode design. 


PowerPDL supports detailed 
algorithm design using pseudocode. 
The built-in Strip utility allows automatic 
design generation of documentation 
from the comments in the code during 
software maintenance. 


QuickChart supports 
Yourdon/Constantine Structured Design 
(with Page-Jones extensions), including 
support for Structure Chart Editing, Data 


Dictionary, and Language Sensitive 
Editors for a variety of languages. 


SmartChart supports Detailed Design 
with automatic Structure Chart Generation 
from Program Design Language, 
Processes Hierarchy Charts with FreeFlow 
and includes Language Sensitive Editors 
for a wide variety of languages. 


Powertools is available both as 
individual modules or in PowerPack 
bundles of 6, 8 or 10 distinct modules of - 
your choice. 


Each individual module is $1,495. 
PowerPack/6: $5,995 
PowerPack/8: $6,995 
PowerPack/10: $7,995 

(Full Product Line) 
Upgrade Service: 15% of purchase 
price, good for one calendar year © 
upgrade. 
Training and Consulting: $3,000 per 
day, plus expenses. 
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MacTech Magazine is your exclusive 
source for these specific products 
including available back issues of 
SFA’s magazine, source code disks 
and assorted cd’s. Call for more info 
and pricing: 


Ad Lib 2.5.1 New version is “fat” binary to 
run native on the PowerMac, and also supports 
the new features of the latest MacApp V3.3. The 
premier MacApp 3.0 compatible ViewEdit 
replacement. A powerful user-interface editing 
tool to build views for MacApp 3.0 and 3.1. Ad 
Lib allows subclassing of all of MacApp’s view 
classes Including adorners, behaviors, and 
drawing environments. String and text style 
resources are managed automatically. Alternate 
display methods, such as a view hierarchy 
window, allow easy examination of complex 
view structures. Ad Lib includes source code for 
MacApp extensions that are supported by the 
editor — buttons can be activated by keystrokes, 
behaviors can be attached to the application 
object, and general purpose behaviors can be 
configured to perform a number of useful 
functions. Run mode allows the user to try out 
the views as they will work in an application. 
Templates can be created to add additional data 
fields to view classes. Editing palettes provide 
fast and easy editing of common objects and 
attributes. Works with ACI’s Object Master 
(version 2.0 and later) to navigate a project’s 
user interface source code. $195 


Five Years of Objects CD-ROM: 
FrameWorks archives and source code from 
April 1991 to January 1993, plus selected 
Object-oriented publicly available software and 
demos. $95 


FrameWorks Magazine: $8/back-issue, 
Subject to availability. 


FrameWorks Source Code Disk: $10 
per back issue, subject to availability. 


MADACON °93 CD-ROM: The highlights 
of MADACON °93, including Mike Potel on Pink, 
Bedrock, MacApp, OODLs, and more. Slides, 
articles, demos, audio, and QuickTime. $95 


MAScript 1.2 adds support for AppleScript 
to your MacApp 3.0.1 and 3.1 based applications. 
Make your application scriptable and recordable 
by building on a tried and tested framework for 
object model support. MAScript dispatches Apple 
events to the appropriate objects, creates object 
specifiers, and makes framework objects like 
windows and documents scriptable and 
recordable. Sample application shows you how to 
begin adding support for scripting and recording. 
MAScript includes complete source code. Install 
MAScript by modifying one MacApp source file, 
then adding another to your project. Future 
versions of MacApp will incorporate MAScript, so 
MAScript support you add now will work in the 
future. $199 


The Mjsiner BETA System is a software 


development environment supporting object- 
Oriented programming in the BETA 
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programming language. BETA Is uniquely 
expressive and orthogonal. BETA unifies just 
about every abstraction mechanism — including 
class, procedure, function, coroutine, process 
and exception — into the ultimate abstraction 
mechanism: the pattern. BETA includes: general 
block structure, strong typing, whole/part 
objects. The compiler: binary code generation, 
automatic garbage collection, separate 
compilation, interface to C, Pascal, and 
assembler. The system: persistent objects, basic 
libraries with containers classes, platform- 
independent GUI application frameworks on 
Unix, Mac and Windows NT, metaprogramming 
system. The tools available on Unix: the hyper 
Structure editor supporting syntax directed 
editing, browsing, etc., and the source code 
debugger are currently being ported to the 
Macintosh system. The Mjginer BETA System 
for Macintosh requires MPW (basic set) 3.2 or 
later. Package containing compiler, basic 
libraries, persistent store, GUI framework, and 
comprehensive documentation. (Other packages 
are also available) $295 


More Savvy includes all Savvy features plus 
Apple Event support for all sub-classes of 
TEventHandler with extensive view support. 
Apple Event support for text includes text 
attributes and sub-range specification. 
Recordability supports additional actions, and 
coercion includes additional types. Additional 
client and server Apple Events. $450 


Savvy 1.1 OSA support includes 
yea attachability, recordability, scripta- 

bility, coercion, in addition to script 
execution, idling and i/o. Apple Event support 
includes complex object specifiers, 
synchronous/asynchronous Apple Event 
handling, and Apple Event transactions for 
clients and servers. The Core Suite of Apple 
Event objects is supported including the 
application, documents, windows, and files. 
Documentation includes technology overview, 
cookbook, and sample code. $250 Savvy now 
supports MPW 3.1, 3.11 and continues to 
support 3.01, as well as supporting Metrowerks 
CodeWarrior. This month only, special 
offer — All Savvy versions include free copy of 
savy QuickTime! 





Savvy QuickTime Requires Savvy, More 
Savvy, or Super Savvy. Includes QuickTime, 
Apple Event, and view template support. Movies 
come out of the box ready to play, edit, and react 
to Apple Events. They can be included in any 
view structure, including templates, and are 
displayed in the scrap view. Movie controls 
include volume, play rate, looping mode, display 
Style, and other characteristics. $250 


Super Savvy includes all More Savvy 
features plus compile, edit, and record scripts 
using built in script editor. View template 
editors, like Ad Lib, can attach scripts to view 
objects and modified scripts are saved with the 
document. Script action behavior allow quick 
access for executing and editing scripts attached 
to views. Text to object specifier coercion plus 
more. $700 





Guide Composer” gives anyone the ability to create 
powerful Apple Guide help systems for any new or existing 
Macintosh application. Great for commercial developers, 
shareware developers, in-house developers, and 
consultants, Guide Composer provides a WYSIWYG 
development environment: Guide content is developed in 
Guide windows. Design topics, phrases, and panels in the 
same format as the user will use them. Features are 
WYSIWYG interface, Topics, phrases, and hierarchical 
phrases, Coach marks, Fully-Integrated with Apple's Guide 
Maker (distributed with Guide Composer), compiles 
scripts automatically, PICTs in Panels, Generated Guide 
scripts are modifiable, Compiled files are 100% Apple 
Guide-compatible and royalty-free. Easy-to-use. $99 










metrowerks Geekware by Metrowerks 


MOUSEDaG $8.95 
Geekware Hawaiian Classic................... $7.95 
Blood, Sweat & Code Black Long Sleeve Shirt . . . $14.95 
Cross Platform White Short Sleeve Shirt........ $14.95 


Mach?eM vnix for Macintosh and Power Macintosh 
MachTen is a Berkeley UNIX that runs on the Classic to the 
Power Mac, including PowerBooks and Duos! So, in 
addition to all of the Macintosh applications, you get a 
Mach-based UNIX with pre-emptive multi-tasking. 
MachTen extends the Macintosh operating system with 
UNIX networking and software development tools. The 
Macintosh/UNIX integration is so strong that you can even 
use Macintosh programs and utilities on UNIX data, and 
UNIX programs and utilities on Macintosh files. Full 
internet protocol support ensures fast, easy client and 
server NFS, e-mail, and file transfer between the 
Macintosh and all TCP-based entities on your network. 
Built-in internet services include domain name service, 
POP mail service, internet routing, SLIP & PPP, and Web 
service. Full X11R5 support with Motif for developing X 
applications and a high performance X server for using 
your Mac as an X terminal. MachTen — Power UNIX $695. 
Personal MachTen (for 68K Macs) $495. Professional 
MachTen (for 68K Macs) $695. MachTen X Window 
Software $350. 


For Macintosh 
Programmers & Developers 








MacTech Mousepad...............0.. S405 $8.95 
“The Information Source” 
MacTech T-Shirt........... 00... cece eee, $14.95 


“Programmer's Don't Do Mornings” 
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AVOID REMOVERESOURCE, IT’LL GET YOU 


I helped a friend with this recently: 

Avoid RemoveResource (or, if you're nstlgic for 
stupid names, RnveResource) if possible. If you need 
to replace a resource, like in a preference file, then 
resize the resource handle if necessary, copy the new 
data into it, and write it out. This tends to increase very 
slightly the possibility “of out of memory” failures due to 
heap fragmentation, but it avoids the only situation (to 
my knowledge) where using Resource Manager calls in 
a straightforward way leaves you open to file 
corruption. RemoveResource immediately shortens 
the resource file by the length of a resource map record. 
If the catalog is flushed, and you then crash or 
otherwise terminate a program without calling 
UpdateResFile, you're hosed. Parts of the resource 
map at the end of the file are snipped off, very likely 
rendering the file unusable by the resource manager. 

I encapsulated the resize/copy/write stuff into a 
routine I called ReplaceResource. If you use 
RemoveResource/AddResource and crash, you could 
lose the whole file. If you use ReplaceResource and 
crash, all you'll lose is the recently added data. I like the 
failure mode where I get to keep most of my data. : 

(Historical anecdote: I learned about this behavior 
during System 7 development. The bug report said 
something like, “Changing the control panel settings 
and then hitting the reset switch makes the system fail 
to boot.” The system file was being shortened by the 
RemoveResource calls. I think we fixed it by calling 
UpdateResFile(2) immediately after removing and 
adding new resources, mostly because it was the 
quickest way to get that bug out of our faces and move 
on to the other two or three thousand. I recommend 
the ReplaceResource’approach, though, because 
there are times when calling UpdateResFile isn't 
appropriate for performance reasons and it’s good to 
use one technique everywhere, instead of “sometimes 
you do this, sometimes you do that...”) 


Greg Marriott 
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FaT Apps CAN PURGE UNWANTED 'CODE's, 
(But THEY’LL STILL BE Far) 


I can’t remember who came up with this one originally, but it’s 
a good one: 

68K development environments like to mark your first one 
or two 'CODE' segments as preloaded. For fat applications, 
though, these resources just take up valuable heap since, they 
never are used but don’t get purged. 

Something like the following should fix the problem: 


#fif GENERATINGPOWERPC 
Handle h; 

h = GetlResource( 'CODE', 0 ); 
if ( h ) ReleaseResource( h ); 


h = GetlResource( 'CODE', 1 ); 
if ( h ) ReleaseResource( h ); 
fFendif 


Note that it is important to use GENERATINGPOWERPC 
instead of GENERATINGCEM, because it is possible for 
GENERATINGCEM to be defined under 68K as well. And if you are 
building a 68K CFM app, you still end up using code segments... 


Eric Shapiro 
[Special thanks to Allan Foster and Marshall Clow on this 
one — the reward is being donated to charity. — sgs | 
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Life is Sweet with JAM! 


~«<- Macintosh 








Windows 95 > 


~<- Character mode 





~<- Windows 3.1, 
Windows NT 
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Get JAM and enjoy real success in building 


serious client/server applications 


In a world where requirements change and deadlines don’t, only JAM gives you what you 
need to build powerful, completely portable client/server and 3-tier applications. JAMs 

cross-platform RAD capabilities enable you to successfully develop and deploy demand- 
ing applications across any platform, database or GUI. 


Are you willing to base your project's success on a tool that only promises portability? 
JAM lets you build great looking applications that are fully portable today. If you need 
to build serious client/server or 3-tier applications, call JYACC for a free demo kit. 


Desktop ease with the power of a 2nd-generation tool 

Unrivaled portability between Windows® 3.1, NT, 95; Macintosh®; OS/2 Warp®; 
Character and Motif 

Unparalleled database access to Oracle®, Sybase®, Informix®, ODBC anda more 
Automatic SQL generation with full transaction control 

Visual repogitory-driven development of both client and application server 
Centralized control over application objects via inheritance 

Unique architecture for team development 

No runtimes 


By Sy a a yO 


Find out for yourself how sweet life can be with JAM! 


Call 1 BOO 458-3315. 


Or E-mail: sweetlife2@jyacc.com for a free demonstration kit. 
Visit our Web site at http://www.jyacc.com 
For international inquiries call: 1-212-267-7722 or FAX 1-212-608-6753 


JAM is a registered trademark of JYACC, Inc. Other trademarks are the property of their respective owners. 
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The choice for Power Macintosh development. 


CodeWarrior Gold includes Macintosh-hosted C/C++ and Object Pascal compiler 
plug-ins for multiple targets, allowing you to create applications for several desktop 
platforms and for specialized operating systems from your Macintosh. One universal 
Integrated Development Environment (IDE) makes it easy to expand your application’s 
market without wasting time learning additional programming environments. 

Even the Macintosh-hosted debugger interface is the same for all targets. 


-New features of CodeWarrior Gold include an integrated class browser, zero 
runtime-overhead exceptions, split panes in the IDE, ANSI library source code, 
debugger watchpoints, ANSI shared library support, full support of template 
debugging and much more. With all of these features, CodeWarrior still maintains 
the small memory footprint it always has (minimum of 8MB Ram is required). 


CodeWarrior Gold compiles for 68K and Power Macintosh™, Windows 95" 
Windows NT™ for x86, Magic Cap™ from General Magic and the new Be™0S 
from Be, Inc. With registration, Metrowerks sends the next two CodeWarrior 
Gold releases at no additional charge. 
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The only source code control system for the Macintosh that is based on and 
compatible with Microsoft Visual SourceSafe version 4.0. Features include 

support for multi-platform projects, security features, reverse delta versioni 
of files, comment areas for each revision, project analysis and reporting tool 


New products also available from Metrowerks: 


CodeWarrior Bronze 8 
Native Macintosh Development Tools for Developing 68K-Native Applications $149 


Discover Programming for Macintosh 
The Official Codewarrior Starter Kit $79 


Inside CodeWarrior 
Complete CodeWarrior Reference $34.9 


Inside PowerPlant™ 
Complete C++ Framework Reference with New Tutorials $34.9 






To order contact Metrowerks: 


voice: (800) 377-5416 [USA and Canada only],(512) 305-0400 fax: (512) 305-0439 
e-mail: sales@metrowerks.com World Wide Web: http://www.metrowerks.com — 





Metrowerks, the Metrowerks logo, PowerPlant and CodeWarrior are registered trademarks of Metrowerks Inc. 
All other companies and products are trademarks of their respective holdings and are hereby recognized. 
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